Proces aplikacji
Aby skorzystać z API rozpoznawania cyfrowych angielskich kodów weryfikacyjnych, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój token API, który należy zachować na przyszłość.
Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę.
Jeden token API wystarczy do wywołania wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku otrzymasz darmowy limit, aby móc skorzystać z usługi za darmo; w przypadku niewystarczającego limitu możesz doładować saldo ogólne w konsoli.
📘 Pełna dokumentacja: API rozpoznawania cyfrowych angielskich kodów weryfikacyjnych →
Podstawowe użycie
Najpierw zapoznaj się z podstawowym sposobem użycia, czyli wprowadź obraz zmiennej długości angielskiego kodu weryfikacyjnego, aby uzyskać przetworzony wynik. Najpierw musisz prosto przekazać poleimage, które jest konkretnym obrazem angielskiego kodu weryfikacyjnego, jak pokazano na rysunku:





accept: jakiego formatu odpowiedzi oczekujesz, tutaj wpiszapplication/json, czyli format JSON.authorization: klucz do wywołania API, po złożeniu wniosku możesz go bezpośrednio wybrać z rozwijanej listy.
image: zakodowany w Base64 obraz kodu weryfikacyjnego (bez prefiksu data:image/png;base64).

text, treść tekstowa przetworzonego obrazu zmiennej długości angielskiego kodu weryfikacyjnego.
text przejdziemy przez weryfikację.
Dodatkowo, jeśli chcesz wygenerować odpowiedni kod do integracji, możesz go bezpośrednio skopiować, na przykład kod CURL wygląda następująco:
Tryb asynchroniczny (async)
Domyślnie API działa w trybie synchronicznym: jedno żądanie będzie czekać, aż wynik rozpoznawania zostanie przetworzony, zanim zostanie zwrócone. Jeśli wykonujesz rotację wielu rozwiązań (multi-solver rotation) i chcesz „natychmiast uzyskać task_id po złożeniu zadania, aby najpierw zająć się innymi rozwiązaniami, a później wrócić po wyniki”, możesz przekazaćasync: true w ciele żądania.
Po przekazaniu async: true interfejs natychmiast zwróci task_id, a nie będzie czekać:
task_id, aby cyklicznie sprawdzać POST /captcha/tasks (zaleca się co 3-5 sekund), aby uzyskać wyniki:
status: processing:
status: ready oraz wynik rozpoznawania text (struktura pól jest całkowicie zgodna z trybem synchronicznym):
/captcha/tasks jest wspólne dla wszystkich interfejsów kodów weryfikacyjnych (token i seria rozpoznawania), można używać tego samego task_id do cyklicznego sprawdzania.
Obsługa błędów
Podczas wywoływania API, jeśli napotkasz błąd, API zwróci odpowiedni kod błędu i informacje. Na przykład:400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacji.429 too_many_requests: Zbyt wiele żądań, przekroczono limit.500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

