Skip to content
On this page
Home
>API
>createTask: Aufgabe erstellen

createTask: Aufgabenerstellung

WARNING

Erstellt eine Aufgabe zur Lösung des ausgewählten Captcha-Typs.

Geben Sie den gewünschten Captcha-Typ in den Parametern an.

Beispiel: ImageToTextTask

Sie können Alle unterstützten Aufgabentypen anzeigen.

Beispielanfrage

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

{
    "clientKey":"YOUR_API_KEY",
    "appId": "APP_ID",
    "task": {
        "type":"ImageToTextTask",// Schreiben Sie unten den zu erkennenden Typ
        "body":"BASE64-Bild"
    }
}

Anforderungsparameter

ParameterTypErforderlichBeschreibung
clientKeyStringYesClient-Kontoschlüssel, der im Dashboard gefunden werden kann
appIdStringNoIhre Entwickler-App-ID, die im Entwicklerbereich des Dashboards beantragt wird
taskObjectYesAufgabenobjekt
callbackUrlStringNoToken wird an diesen Endpunkt (POST) gesendet

Beispielantwort

Beispielantwort für asynchrone Aufgaben

Wenn eine Aufgabe als Token-Aufgabe oder spezielle asynchrone Aufgabe erstellt wird, wird das Taskergebnis über den Befehl getTaskResult abgerufen.

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // Speichern Sie diese ID für den nächsten Schritt
}

Beispielantwort für synchrone Aufgaben

Wenn der Aufgabentyp Bilderkennung, Spracherkennung oder einige spezielle Aufgaben ist, wird das Aufgabenergebnis direkt zurückgegeben. Es kann anhand der Gleichheit von status mit ready beurteilt werden.

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "status": "ready",
    "solution": {
        "text": "44795sds"
    },
    "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b",
}

Antwortstruktur

ParameterTypBeschreibung
errorIdIntegerFehlermeldung:
0 - kein Fehler
1 - mit Fehler
errorCodeStringFehlercode-Tabelle
errorDescriptionStringFehlerbeschreibung
statusStringGibt den Status zurück, der nur null oder ready sein kann
solutionObjectDie Synchronisationsaufgabe gibt ein Ergebnis zurück
taskIdStringID der erstellten Aufgabe, Ergebnisse der Aufgabe abrufen