# getTaskResult – Ergebnis abrufen

> POST /getTaskResult liefert das Ergebnis einer asynchronen Aufgabe. Fragen Sie alle 5 Sekunden ab, warten Sie bei processing weiter, lesen Sie bei ready die solution und beenden Sie die Abfrage bei Fehlern; Aufgaben laufen bis zu etwa 110 Sekunden, Ergebnisse bleiben etwa 10 Minuten erhalten, Abfragen kosten keine Punkte.

Source: https://docs.yescaptcha.com/de/api/get-task-result/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/api/get-task-result/

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

- POST `https://api.yescaptcha.com/getTaskResult` (Globaler Endpoint)
- POST `https://cn.yescaptcha.com/getTaskResult` (China-Endpoint)

## Anfrageparameter

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `clientKey` | string | Ja | Ihr ClientKey, derselbe wie beim Erstellen der Aufgabe |
| `taskId` | string | Ja | Die von [createTask](https://docs.yescaptcha.com/de/api/create-task.md) zurückgegebene Aufgaben-ID |

```json
{
  "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):

```json
{
  "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](https://docs.yescaptcha.com/de/api/rate-limits.md) 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.