getTaskResult: Anforderung von Aufgabenergebnissen

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

Die maximale Anzahl von Abfrageanfragen für jede Aufgabe beträgt 120. Wenn die Anzahl der Abfrageanfragen überschritten wird, gehen die Aufgabenergebnisse verloren.
Jede Aufgabe kann innerhalb von 5 Minuten nach ihrer Erstellung abgefragt werden und geht nach Überschreitung der Zeit verloren.
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

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

Parameter	Typ	Erforderlich	Beschreibung
clientKey	string	Yes	Client-Kontoschlüssel, der hier gefunden werden kann
taskId	string	Yes	ID erstellt durch die createTask-Methode

Beispielantwort

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

Antwortstruktur

Parameter	Typ	Beschreibung
errorId	Integer	Fehlermeldung: 0 - kein Fehler 1 - mit Fehler
errorCode	String	Fehlercode: vollständige Liste der Fehler
errorDescription	String	Fehlerbeschreibung
status	String	• Leerlauf - Warten • Verarbeitung - Identifizierung läuft • Bereit - Die Identifizierung ist abgeschlossen und das Ergebnis befindet sich im Lösungsparameter
solution	Object	Aufgabenergebnisdaten. 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

createTask: Aufgabe erstellen Parameter