POST /captcha/tasks. Коли ви викликаєте будь-який інтерфейс перевірочного коду (серія токенів або серія розпізнавання) з параметром async: true, інтерфейс негайно повертає task_id, сервер негайно бере на себе обробку та продовжує її; ви можете використовувати цей task_id для запиту остаточного результату, але запит не є умовою для продовження виконання завдання. Підходить для сценаріїв ротації багатокодерів (multi-solver rotation): після подання завдання ви негайно отримуєте task_id, спочатку можете налаштувати інших кодерів, а потім повернутися для читання результату.
📘 Повна інтерактивна документація (включаючи онлайн налагодження): API запиту завдань з перевірочним кодом →
Процес подання заявки
Щоб використовувати цей інтерфейс, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, залиште його на випадок потреби. Один API Token дозволяє викликати всі сервіси платформи, не потрібно окремо запитувати для кожного сервісу.Основне використання
Перший крок: створення завдання асинхронно
У тілі запиту до будь-якого інтерфейсу перевірочного коду передайтеasync: true, інтерфейс негайно поверне task_id (HTTP 201), не блокуючи очікування:
Другий крок (необов’язковий): запит результату за допомогою task_id
Якщо потрібно активно перевірити прогрес, ви можете використовуватиtask_id, отриманий на попередньому кроці, для запиту POST /captcha/tasks (рекомендується кожні 3~5 секунд). Цей інтерфейс не запустить або не прискорить обробку завдання; при читанні готових результатів зберігається існуюча одноразова поведінка розрахунку:
status: processing:
status: ready та відповідні поля результату — структура полів повністю відповідає синхронному режиму:
- серія токенів (hcaptcha, recaptcha2, recaptcha3) повертає
token:
- категорія розпізнавання (recognition/recaptcha2, recognition/hcaptcha) повертає
solution; recognition/image2text повертаєtext.
/captcha/tasks є універсальним для всіх інтерфейсів перевірочного коду (серії токенів та розпізнавання), можна використовувати один і той же task_id для опитування.
Сервер продовжує обробку з моменту створення, максимальний час — 120 секунд. Якщо на останньому запиті до дедлайну результат не буде отримано, буде повернуто HTTP 504. Цей статус є кінцевим, клієнт повинен зупинити опитування; повторний запит одного й того ж task_id стабільно поверне однаковий результат помилки:
status: ready та кінцеві відповіді HTTP 504 завжди міститимуть поля часу.
started_at, час початку обробки завдання, Unix-час (секунди, з плаваючою комою).finished_at, час отримання результату завдання, Unix-час (секунди, з плаваючою комою). Не повертається, якщо ще в обробці.elapsed, час обробки завдання, одиниця — секунди (з плаваючою комою, з 3 знаками після коми). Не повертається, якщо ще в обробці.
Інформація про тарифи
В асинхронному режимі створення завдання та читання статусу “в обробці” не підлягають оплаті; клієнт сплачує один раз при першому успішному отриманні результату (згідно з існуючою поведінкою та цінами синхронного режиму). Сервер самостійно просуває завдання, але не стягує плату за те, що завдання завершилося раніше в фоновому режимі. Завдання, які не були успішно завершені протягом 120 секунд, закінчуються з HTTP 504 і не підлягають оплаті.Обробка помилок
При виклику цього інтерфейсу, якщо виникає помилка, буде повернуто відповідний код помилки та інформацію. Наприклад:400 invalid_request: запит не містить параметраtask_id.401 invalid_token: неавторизовано, токен авторизації недійсний або відсутній.404 not_found:task_idне існує або не належить поточному обліковому запису.504 timeout: завдання завершено і не дало результату; будь ласка, зупиніть опитування цьогоtask_id. Ця помилка не призведе до стягнення плати.