POST /captcha/tasks. Когда вы вызываете любой интерфейс CAPTCHA (серия токенов или серия распознавания) с параметром async: true, интерфейс немедленно возвращает task_id, сервер сразу берет на себя обработку и продолжает ее; вы можете использовать этот task_id для запроса окончательного результата, но запрос не является условием для продолжения выполнения задачи. Подходит для сценариев с ротацией многократных решателей (multi-solver rotation): после отправки задачи вы сразу получаете task_id, сначала можете задействовать других решателей, а позже вернуться и прочитать результат.
📘 Полная интерактивная документация (включая онлайн-отладку): API запроса задач CAPTCHA →
Процесс подачи заявки
Чтобы использовать этот интерфейс, сначала перейдите в консоль Ace Data Cloud и получите ваш API Token для резервного копирования. Одного API Token достаточно для вызова всех сервисов платформы, не нужно запрашивать отдельный для каждого сервиса.Основное использование
Шаг 1: Создание задачи асинхронным способом
В теле запроса любого интерфейса CAPTCHA передайтеasync: true, интерфейс немедленно вернет task_id (HTTP 201), не блокируя ожидание:
Шаг 2 (необязательно): Запрос результата с помощью 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 универсален для всех интерфейсов CAPTCHA (серии токенов и распознавания), можно использовать один и тот же 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. Эта ошибка не приведет к оплате.