getTaskResult – Ergebnis abrufen

getTaskResult liefert das Ergebnis einer asynchronen Aufgabe. Rufen Sie die Methode nach dem Erstellen der Aufgabe alle 5 Sekunden auf: Bei processing warten Sie weiter, bei ready steht das Ergebnis in solution, bei einem Fehler beenden Sie die Abfrage. Abfragen verursachen keinen Punkteabzug, egal wie oft Sie abfragen.

POSThttps://api.yescaptcha.com/getTaskResultGlobaler EndpointKopieren

POSThttps://cn.yescaptcha.com/getTaskResultChina-EndpointKopieren

Anfrageparameter

Feld	Typ	Pflicht	Beschreibung
clientKey	string	Ja	Ihr ClientKey, derselbe wie beim Erstellen der Aufgabe
taskId	string	Ja	Die von createTask zurückgegebene Aufgaben-ID

{
  "clientKey": "YOUR_CLIENT_KEY",
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Rückgabe

Situation	Rückgabe	Was zu tun ist
In Bearbeitung	errorId ist 0, status ist processing	In 5 Sekunden erneut abfragen
Fertig	errorId ist 0, status ist ready, das Ergebnis steht in solution	solution auslesen; die Felder stehen auf den Seiten der einzelnen Aufgabentypen
Nicht gelöst	errorId ist 1, errorCode ist ERROR_CAPTCHA_UNSOLVABLE	Die Punkte wurden automatisch erstattet, Sie können die Aufgabe neu erstellen
Zeitüberschreitung	errorId ist 1, errorCode ist ERROR_TASK_TIMEOUT	Die Punkte wurden automatisch erstattet, Sie können die Aufgabe neu erstellen
Aufgabe nicht vorhanden oder abgelaufen	errorId ist 1, errorCode ist ERROR_TASKID_INVALID	Diese taskId nicht mehr abfragen

Beispiel für eine fertige Aufgabe (reCAPTCHA v2):

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnU..."
  }
}

Regeln

• Alle 5 Sekunden abfragen. Wiederholte Abfragen derselben taskId innerhalb von 5 Sekunden liefern sofort processing; häufigeres Abfragen macht nichts schneller.
• Eine Aufgabe wird höchstens etwa 110 Sekunden bearbeitet (bei wenigen Typen 180 bis 220 Sekunden). Danach wird ERROR_TASK_TIMEOUT zurückgegeben und die Punkte werden automatisch erstattet. Als Obergrenze für das Warten im Programm empfehlen sich etwa 3 Minuten.
• Ergebnisse bleiben etwa 10 Minuten erhalten, danach wird die taskId ungültig und liefert ERROR_TASKID_INVALID. Verwenden Sie das Ergebnis möglichst sofort: Das Token selbst ist kürzer gültig (reCAPTCHA etwa 120 Sekunden).
• Bei Fehlern beenden. Nach errorId: 1 ändert sich das Ergebnis nicht, wenn Sie dieselbe taskId weiter abfragen; ab der 3. Abfrage einer bereits beendeten Aufgabe weist errorDescription am Ende darauf hin, die Abfrage zu beenden. ERROR_TASKID_INVALID zählt für die Fehleranzahl der automatischen Pausierung mit (dieselbe ID wird nur beim ersten Mal gezählt).
• Fragen Sie auf demselben Endpoint ab, auf dem Sie die Aufgabe erstellt haben.
• getTaskResult ist von der automatischen Pausierung nicht betroffen: Aufgaben, die vor der Pausierung erstellt wurden, können weiterhin abgefragt werden.