Skip to content
On this page
Home
>API
>getTaskResult: Aufgabenergebnis

getTaskResult: Anforderung von Aufgabenergebnissen

Wenn die von createTask initiierte Aufgabe eine asynchrone Aufgabe ist, erhalten Sie das Ergebnis der asynchronen Aufgabe über getTaskResult.

  1. Die maximale Anzahl von Abfrageanfragen für jede Aufgabe beträgt 120. Wenn die Anzahl der Abfrageanfragen überschritten wird, gehen die Aufgabenergebnisse verloren.
  2. Jede Aufgabe kann innerhalb von 5 Minuten nach ihrer Erstellung abgefragt werden und geht nach Überschreitung der Zeit verloren.
  3. Das Erkennungsergebnis, das auf diese Weise erhalten wird, hängt von der Systemauslastung ab. Sie erhalten das Ergebnis innerhalb eines Zeitintervalls von 1 Sekunde bis 30 Sekunden.

WARNING

Bitte beachten Sie, dass nicht alle Aufgaben auf diese Weise Ergebnisse abrufen müssen. Die folgenden beiden Aufgabentypen müssen die Dokumente überprüfen.

  • Aufgabentypen der Klasse "Identifizieren", wie ImageToText, usw., die direkt über createTask synchronisiert werden und Ergebnisse zurückgeben.

Beispielanfrage

json
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json

{
    "clientKey": "YOUR_API_KEY",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // ID erstellt durch die Methode createTask
}

Anforderungsparameter

ParameterTypErforderlichBeschreibung
clientKeystringYesClient-Kontoschlüssel, der hier gefunden werden kann
taskIdstringYesID erstellt durch die createTask-Methode

Beispielantwort

json
{
    "errorId": 0,
    "solution": {
        "userAgent": "xxx",
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
    },
    "status": "ready"
}

Antwortstruktur

ParameterTypBeschreibung
errorIdIntegerFehlermeldung:
0 - kein Fehler
1 - mit Fehler
errorCodeStringFehlercode: vollständige Liste der Fehler
errorDescriptionStringFehlerbeschreibung
statusString• Leerlauf - Warten
• Verarbeitung - Identifizierung läuft
• Bereit - Die Identifizierung ist abgeschlossen und das Ergebnis befindet sich im Lösungsparameter
solutionObjectAufgabenergebnisdaten. Unterschiedlich für jeden Aufgabentyp

Antwortspezifikation

  • Erkennung erfolgreich: Wenn errorId gleich 0 und status gleich bereit ist, befindet sich das Ergebnis in solution.

  • Identifizierung: Wenn errorId gleich 0 und status gleich Verarbeitung ist, versuchen Sie es bitte in 3 Sekunden erneut.

  • Fehler: Wenn errorId größer als 0 ist, erfahren Sie die Fehlerinformationen gemäß errorDescription.

    Fehlercode: vollständige Liste der Fehler