UNLOCK API
مفتاح API
إشعارات النتيجة
MarkdownOpenAPI

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

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

طرق 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
}

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، لذا احتفظ بتحقق احتياطي.
  • لا يُتحقق من رد خادمك، ولا يُعاد الإرسال إذا فشل التسليم.