UNLOCK API
API key
Mga result callback
MarkdownOpenAPI

Mga result callback

Ipadala ang resulta sa server mo sa halip na i-check mo ito.

Mga JSON method

Idagdag ang callbackUrl sa createTask. Kapag tapos na ang task, ipapadala ang resulta sa address na iyon sa POST na may JSON body na kahugis ng getTaskResult, dagdag ang taskId. Ang failed task ay nagpapadala ng errorId 1 kasama ang 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
}

Form API

Idagdag ang pingback sa in.php. Kapag tapos na ang task, makakatanggap ang address ng POST form body na may id (ang task id) at code (ang sagot, o ang pangalan ng error).
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...

Mga patakaran

  • Dapat pampublikong http o https ang address. Hindi tinatawagan ang private, local at loopback na address.
  • Isang subok na may 5 segundong timeout. Available pa rin ang resulta gamit ang getTaskResult at res.php, kaya maglagay ng fallback check.
  • Hindi chine-check ang sagot ng server mo, at hindi inuulit ang nabigong delivery.