Процес подачі заявки
Щоб використовувати API для ідентифікації протоколу Cloudflare Turnstile, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, зберігайте його для подальшого використання.
Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, щоб запросити реєстрацію та вхід, після чого ви будете автоматично повернені на цю сторінку.
Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо подавати заявку на кожну послугу. Перший запит на отримання токена надає безкоштовний ліміт для тестування; якщо ліміт вичерпано, ви можете поповнити загальний баланс у консолі.
📘 Повна документація: Cloudflare Turnstile протокол ідентифікації API →
Основне використання
Спочатку розгляньте основний спосіб використання, а саме введіть URL сайту, для якого потрібно обробити CAPTCHA Turnstile, щоб отримати оброблений результат. Спочатку потрібно просто передати полеwebsite_url, наш приклад сайту: https://react-turnstile.vercel.app, нам потрібно отримати website_key на сторінці website_url, для цього відкрийте цю веб-сторінку, натисніть F12 для входу в консоль, на вкладці Element виконайте глобальний пошук cf-turnstile, ви знайдете контейнерний елемент, що містить Turnstile, де data-sitekey відповідає рядку, що є значенням website_key.
Налаштовані заголовки запиту включають:
accept: формат відповіді, який ви хочете отримати, тут вказуєтьсяapplication/json, тобто формат JSON.authorization: ключ для виклику API, після подачі заявки ви можете вибрати його зі списку.
website_url: URL сайту, для якого потрібно обробити CAPTCHA.website_key: ідентифікатор сайту в Cloudflare Turnstile (sitekey).action: необов’язковий параметр, передається лише тоді, коли цільовий сайт має налаштовану користувацькуactionдля компонента Turnstile.cdata: необов’язковий параметр, передається лише тоді, коли цільовий сайт має налаштовану користувацькуcDataдля компонента Turnstile.
token, результат перевірки для обробленої CAPTCHA Turnstile.started_at,finished_at: час початку обробки запиту та отримання результату, Unix-час (секунди, з плаваючою комою).elapsed: загальний час обробки (секунди).
cf-turnstile-response на цільовий сайт, код Python для виклику перевірки токена виглядає так:
Асинхронний режим (async)
За замовчуванням API є синхронним і блокує: один запит буде чекати, поки токен не буде оброблено, перш ніж повернути результат. Якщо ви займаєтеся ротацією багатьох рішень (multi-solver rotation) і хочете «одразу отримати task_id після подачі завдання, спочатку налаштувати інші рішення, а потім повернутися для отримання результату», ви можете передатиasync: true у тілі запиту.
Після передачі async: true інтерфейс негайно поверне task_id, не блокуючи очікування:
task_id для запиту POST /captcha/tasks (рекомендується кожні 3-5 секунд). Цей інтерфейс не запускає або не просуває обробку завдання; навіть якщо не запитувати, відключити інтернет або вийти з клієнта, сервер все ще продовжить обробку:
status: processing; після завершення обробки буде повернуто status: ready і токен:
timeout, без тарифікації. /captcha/tasks не відповідає за просування завдання.
Примітка: Cloudflare Turnstile наразі не підтримує власні проксі (Bring Your Own Proxy), тому цей інтерфейс не приймає параметрproxy; якщо передати, буде повернуто400 invalid_proxy.
Обробка помилок
При виклику API, якщо виникає помилка, API поверне відповідний код помилки та інформацію. Наприклад:400 token_mismatched:Неправильний запит, можливо, через відсутні або недійсні параметри.400 invalid_proxy:Неправильний запит, проксі не підтримується для цього типу капчі.401 invalid_token:Неавторизовано, недійсний або відсутній токен авторизації.429 too_many_requests:Занадто багато запитів, ви перевищили ліміт запитів.500 api_error:Внутрішня помилка сервера, щось пішло не так на сервері.

