UNLOCK API
getTaskResult

getTaskResult

ترجع حالة المهمة. أثناء الحل تكون قيمة status هي processing. عند الانتهاء تكون status هي ready ويحتوي solution على الإجابة. المهمة الفاشلة ترجع errorId 1 مع السبب، ويكون مبلغها قد عاد إلى الرصيد.
POSThttps://unlock-api.com/getTaskResult
انتظر نحو 5 ثوانٍ بعد إنشاء المهمة، ثم تحقق كل 5 ثوانٍ. المهمة التي لا تُحل خلال 5 دقائق تفشل بالخطأ ERROR_CAPTCHA_UNSOLVABLE.

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

clientKey
Stringمطلوب
مفتاح API الخاص بك، 32 حرفًا، من صفحة الحساب.
taskId
Integerمطلوب
المعرّف الذي أرجعته createTask.

الطلب

POST /getTaskResult
{
  "clientKey": "YOUR_API_KEY",
  "taskId": 1001
}

الاستجابة

{
  "errorId": 0,
  "status": "processing",
  "taskId": 1001
}

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

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

أمثلة الكود

curl -s https://unlock-api.com/getTaskResult \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"YOUR_API_KEY","taskId":1001}'

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

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

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

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

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

  • لا توجد مهمة بهذا المعرف في حسابك.

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