POST /captcha/tasks. Wenn Sie bei der Verwendung einer beliebigen Captcha-Schnittstelle (Token-Serie oder Erkennungsserie) async: true übergeben, gibt die Schnittstelle sofort eine task_id zurück, der Server übernimmt sofort und verarbeitet weiter; Sie können diese task_id verwenden, um das endgültige Ergebnis abzufragen, aber die Abfrage ist nicht die Voraussetzung für die Fortsetzung der Aufgabenbearbeitung. Dies ist geeignet für Szenarien wie Multi-Solver-Rotation: Nachdem Sie die Aufgabe eingereicht haben, erhalten Sie sofort die task_id, um andere Solver zu planen und später zurückzukehren, um die Ergebnisse abzurufen.
📘 Vollständige interaktive Dokumentation (einschließlich Online-Debugging): API zur Abfrage von Captcha-Aufgaben →
Antragsprozess
Um diese Schnittstelle zu verwenden, gehen Sie zuerst zur Ace Data Cloud-Konsole, um Ihr API-Token zu erhalten, das Sie als Reserve aufbewahren. Ein API-Token kann alle Dienste der Plattform aufrufen, es ist nicht erforderlich, für jeden Dienst separat zu beantragen.Grundlegende Verwendung
Schritt 1: Aufgabe asynchron erstellen
Übergeben Sie in der Anfrage an eine beliebige Captcha-Schnittstelleasync: true, die Schnittstelle gibt sofort eine task_id zurück (HTTP 201), ohne zu blockieren und zu warten:
Schritt 2 (optional): Ergebnisse mit task_id abfragen
Wenn Sie den Fortschritt aktiv überprüfen möchten, können Sie die in Schritt 1 zurückgegebenetask_id verwenden, um POST /captcha/tasks abzufragen (empfohlen alle 3-5 Sekunden). Diese Schnittstelle löst oder beschleunigt die Aufgabenbearbeitung nicht; beim Abrufen der bereitstehenden Ergebnisse wird das bestehende einmalige Abrechnungsverhalten beibehalten:
status: processing zurückgegeben:
status: ready und das entsprechende Ergebnisfeld zurückgegeben – die Feldstruktur ist identisch mit der im synchronen Modus:
- Token-Serie (hcaptcha, recaptcha2, recaptcha3) gibt
tokenzurück:
- Erkennungs-Kategorie (recognition/recaptcha2, recognition/hcaptcha) gibt
solutionzurück; recognition/image2text gibttextzurück.
/captcha/tasks ist für alle Captcha-Schnittstellen (Token- und Erkennungsserie) allgemein und kann mit derselben task_id abgefragt werden.
Der Server verarbeitet kontinuierlich ab dem Zeitpunkt der Erstellung, maximal 120 Sekunden. Wenn bei der letzten Abfrage vor Ablauf der Frist noch kein Ergebnis vorliegt, wird HTTP 504 persistiert. Dieser Status ist der Endstatus, der Client sollte die Abfrage einstellen; wiederholte Abfragen derselben task_id geben stabil dasselbe Fehlermeldungsergebnis zurück:
status: ready als auch die HTTP 504-Endstatusantwort enthalten Zeitstempelfelder.
started_at, Zeitpunkt des Beginns der Aufgabenbearbeitung, Unix-Zeitstempel (Sekunden, Fließkomma).finished_at, Zeitpunkt der Ergebnisproduktion der Aufgabe, Unix-Zeitstempel (Sekunden, Fließkomma). Wird während der Verarbeitung nicht zurückgegeben.elapsed, Zeitaufwand für die Aufgabenbearbeitung, Einheit in Sekunden (Fließkomma, auf 3 Dezimalstellen gerundet). Wird während der Verarbeitung nicht zurückgegeben.
Abrechnungsinformationen
Im asynchronen Modus werden die Erstellung von Aufgaben und das Abrufen des „Verarbeitungs“-Status nicht abgerechnet; der Client wird einmal abgerechnet, wenn das erste erfolgreiche Ergebnis abgerufen wird (entspricht dem bestehenden Verhalten und den Preisen im synchronen Modus). Der Server wird die Aufgaben selbstständig vorantreiben, aber es wird keine vorzeitige Abrechnung erfolgen, nur weil die Verarbeitung im Hintergrund abgeschlossen ist. Aufgaben, die innerhalb von 120 Sekunden nicht erfolgreich sind, werden mit HTTP 504 beendet und nicht abgerechnet.Fehlerbehandlung
Wenn beim Aufruf dieser Schnittstelle ein Fehler auftritt, wird der entsprechende Fehlercode und die Fehlermeldung zurückgegeben. Zum Beispiel:400 invalid_request: Anfrage fehlt den Parametertask_id.401 invalid_token: Unautorisiert, der Autorisierungstoken ist ungültig oder fehlt.404 not_found:task_idexistiert nicht oder gehört nicht zum aktuellen Konto.504 timeout: Die Aufgabe wurde beendet und hat kein Ergebnis produziert; bitte stoppen Sie die Abfrage diesertask_id. Dieser Fehler wird nicht abgerechnet.