Ergebnis-Callbacks

Lassen Sie das Ergebnis an Ihren Server senden, statt es abzufragen.

JSON-Methoden

Fügen Sie createTask callbackUrl hinzu. Ist die Aufgabe fertig, wird das Ergebnis per POST an diese Adresse gesendet, mit einem JSON-Body wie bei getTaskResult plus taskId. Eine fehlgeschlagene Aufgabe sendet errorId 1 mit 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"
}

Formular-API

Fügen Sie in.php pingback hinzu. Ist die Aufgabe fertig, erhält die Adresse einen POST-Formular-Body mit id (die Aufgaben-ID) und code (die Antwort oder der Fehlername).

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...

Regeln

Die Adresse muss öffentlich und http oder https sein. Private, lokale und Loopback-Adressen werden nicht aufgerufen.
Ein Versuch mit 5 Sekunden Timeout. Das Ergebnis bleibt auch über getTaskResult und res.php abrufbar, behalten Sie also eine Ersatzprüfung bei.
Die Antwort Ihres Servers wird nicht geprüft, und eine fehlgeschlagene Zustellung wird nicht wiederholt.