UNLOCK API
getToken

getToken

تنشئ مهمة وتنتظر الإجابة في الطلب نفسه، حتى 50 ثانية. إذا لم تنته المهمة خلال ذلك، يكون الرد status processing مع taskId؛ تابع التحقق منها عبر getTaskResult. لا تُرسل إشعارات النتيجة لمهام getToken.
POSThttps://unlock-api.com/getToken
اضبط مهلة عميل HTTP على أكثر من 60 ثانية لهذه الطريقة.

معاملات الطلب

clientKey
Stringمطلوب
مفتاح API الخاص بك، 32 حرفًا، من صفحة الحساب.
task
Objectمطلوب
كائن المهمة. الحقل type فيه يحدد الحقول الأخرى المطلوبة. أنواع المهام
softId
Integerاختياري
معرّف تطبيقك، يُحفظ مع المهمة. يُقبل appId كالحقل نفسه.

الطلب

POST /getToken
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "TurnstileTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
  }
}

الاستجابة

{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p..."
  },
  "cost": "0.00055",
  "createTime": 1791640000,
  "endTime": 1791640011,
  "solveCount": 1
}

حقول الاستجابة

errorId
Integer
0 عند نجاح الطلب، و1 عند فشله.
taskId
Integer
معرّف المهمة.
status
String
processing أثناء حل المهمة، وready عند انتهائها.
solution
Object
الإجابة. حقولها تعتمد على نوع المهمة.
cost
String
سعر هذه المهمة بالدولار الأمريكي.

أمثلة الكود

curl -s https://unlock-api.com/getToken \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"YOUR_API_KEY","task":{"type":"TurnstileTaskProxyless","websiteURL":"https://example.com/login","websiteKey":"0x4AAAAAAAC3DHQFLr1GavRN"}}'

الأخطاء التي قد ترجعها هذه الطريقة

  • المفتاح غير صحيح. انسخه مرة أخرى من صفحة الحساب. (في in.php وres.php: ERROR_WRONG_USER_KEY)

  • جاء الطلب من عنوان IP غير موجود في قائمة الحساب المسموحة. أضف العنوان من صفحة الحساب.

  • هذا الحساب محظور. تواصل مع الدعم من صفحة الحساب.

  • طلبات كثيرة. خفّف التحقق من النتيجة إلى مرة كل 5 ثوانٍ.

  • الرصيد لا يكفي للمهمة. اشحن رصيدك، ولم يُخصم أي شيء.

  • الطلبات كثيرة الآن، فلم تُقبل المهمة. حاول مرة أخرى بعد بضع ثوانٍ، ولم يُخصم أي شيء.

  • نوع المهمة غير معروف أو معطل. تحقق من اسم النوع.

  • حقل مطلوب مفقود أو بصيغة خاطئة.

  • قيمة websiteURL أو pageurl مفقودة أو ليست عنوان http(s) كاملًا.

  • تعذر حل المهمة في الوقت المحدد. عاد مبلغها إلى رصيدك.