POST /captcha/tasks. Gdy wywołujesz dowolny interfejs CAPTCHA (seria tokenów lub seria rozpoznawania) z parametrem async: true, interfejs natychmiast zwraca task_id, a serwer przejmuje i kontynuuje przetwarzanie; możesz użyć tego task_id, aby sprawdzić ostateczny wynik, ale zapytanie nie jest warunkiem kontynuacji zadania. Odpowiednie do scenariuszy rotacji wielu rozwiązywaczy (multi-solver rotation): po złożeniu zadania natychmiast otrzymujesz task_id, a następnie możesz zlecić inne rozwiązywacze, a później wrócić, aby odczytać wyniki.
📘 Pełna interaktywna dokumentacja (w tym online debugging): API do zapytania o zadania CAPTCHA →
Proces aplikacji
Aby skorzystać z tego interfejsu, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój token API, który należy zachować na przyszłość. Jeden token API wystarczy do wywołania wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi.Podstawowe użycie
Krok pierwszy: utworzenie zadania w trybie asynchronicznym
W ciele żądania dowolnego interfejsu CAPTCHA przekażasync: true, a interfejs natychmiast zwróci task_id (HTTP 201), nie blokując oczekiwania:
Krok drugi (opcjonalny): zapytanie o wynik za pomocą task_id
Jeśli chcesz aktywnie sprawdzić postęp, możesz użyćtask_id zwróconego w poprzednim kroku, aby zapytać POST /captcha/tasks (zaleca się co 3-5 sekund). Ten interfejs nie uruchomi ani nie przyspieszy przetwarzania zadania; odczytując gotowy wynik, zachowaj istniejące zachowanie jednorazowego rozliczenia:
status: processing:
status: ready oraz odpowiednie pola wynikowe — struktura pól jest całkowicie zgodna z trybem synchronizacji:
- seria tokenów (hcaptcha, recaptcha2, recaptcha3) zwraca
token:
- klasyfikacja rozpoznawania (recognition/recaptcha2, recognition/hcaptcha) zwraca
solution; recognition/image2text zwracatext.
/captcha/tasks jest uniwersalne dla wszystkich interfejsów CAPTCHA (seria tokenów i rozpoznawania), wystarczy użyć tego samego task_id do zapytań.
Serwer kontynuuje przetwarzanie od momentu utworzenia, maksymalnie przez 120 sekund. Jeśli podczas ostatniego zapytania przed upływem terminu nadal nie uzyskano wyniku, zwróci HTTP 504. Ten status jest stanem końcowym, klient powinien zaprzestać zapytań; powtarzające się zapytania o ten sam task_id będą stabilnie zwracać ten sam wynik błędu:
status: ready, jak i HTTP 504 będą zawierać pola czasowe.
started_at, czas rozpoczęcia przetwarzania zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa).finished_at, czas uzyskania wyniku zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa). Nie jest zwracane, gdy nadal jest w trakcie przetwarzania.elapsed, czas przetwarzania zadania, jednostka to sekundy (liczba zmiennoprzecinkowa, z dokładnością do 3 miejsc po przecinku). Nie jest zwracane, gdy nadal jest w trakcie przetwarzania.
Informacje o opłatach
W trybie asynchronicznym, tworzenie zadań i odczytywanie statusu „w trakcie przetwarzania” nie są obciążane opłatami; klient jest obciążany jednorazowo przy pierwszym odczycie udanego wyniku (zgodnie z istniejącym zachowaniem i cenami w trybie synchronizacji). Serwer samodzielnie przyspiesza zadania, ale nie obciąży opłatami, jeśli zadanie zakończy się w tle. Zadania, które nie zakończą się pomyślnie w ciągu 120 sekund, są kończone z HTTP 504 i nie są obciążane opłatami.Obsługa błędów
Podczas wywoływania tego interfejsu, jeśli wystąpią błędy, zwróci odpowiedni kod błędu i informacje. Na przykład:400 invalid_request: Żądanie brakuje parametrutask_id.401 invalid_token: Brak autoryzacji, token autoryzacyjny jest nieprawidłowy lub brakujący.404 not_found:task_idnie istnieje lub nie należy do bieżącego konta.504 timeout: Zadanie zostało zakończone i nie wygenerowało wyniku; proszę zaprzestać zapytań o tentask_id. Ta awaria nie będzie obciążana opłatami.