إشعارات النتيجة

استلم النتيجة على خادمك بدل التحقق منها.

طرق JSON

أضف callbackUrl إلى createTask. عند انتهاء المهمة، تُرسل النتيجة إلى ذلك العنوان عبر POST بجسم JSON بشكل getTaskResult نفسه، مع taskId. المهمة الفاشلة ترسل errorId 1 مع errorCode.

POST /createTask

{
  "clientKey": "YOUR_API_KEY",
  "callbackUrl": "https://your-server.com/captcha-result",
  "task": {
    "type": "TurnstileTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
  }
}

POST https://your-server.com/captcha-result

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

{
  "errorId": 1,
  "taskId": 1001,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE"
}

API النماذج

أضف pingback إلى in.php. عند انتهاء المهمة، يستلم العنوان جسم نموذج عبر POST فيه id (معرّف المهمة) وcode (الإجابة، أو اسم الخطأ).

in.php

curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=turnstile&sitekey=SITE_KEY&pageurl=https://example.com/login&pingback=https://your-server.com/captcha-result"

# POST https://your-server.com/captcha-result
# Content-Type: application/x-www-form-urlencoded
# id=1001&code=0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p...

القواعد

يجب أن يكون العنوان http أو https عامًا. العناوين الخاصة والمحلية وعناوين loopback لا تُستدعى.
محاولة واحدة بمهلة 5 ثوانٍ. تبقى النتيجة متاحة أيضًا عبر getTaskResult وres.php، لذا احتفظ بتحقق احتياطي.
لا يُتحقق من رد خادمك، ولا يُعاد الإرسال إذا فشل التسليم.

إشعارات النتيجة

طرق JSON

API النماذج

القواعد

إنشاء حساب

إنشاء حساب