[ ИНТЕГРАЦИЯ ]

Решение капчи для
cURL

Проходите проверку прямо в ходе запуска, а не проваливайте задание. Рабочий пример на Shell и три фактора, от которых зависит, будет ли принят ваш токен.

cURL · Shell

curl -X POST "https://api.captchano.com/v1/solve?wait=60" \
  -H "Authorization: Bearer cn-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "type": "recaptcha_v2",
        "sitekey": "6LcABC...",
        "url": "https://example.com/login",
        "proxy": "http://user:pass@host:port"
      }'

# 200 OK
# { "id": "slv_…", "status": "ready",
#   "solution": { "token": "03AGdBq25S…" },
#   "cost": "0.00598", "solveTime": 18.4 }

От чего зависит, будет ли принят токен

Передавайте свой прокси. Токен должен быть получен с того же исходящего IP, с которого он отправляется. Для систем с оценкой сессии это обязательное условие, а не оптимизация.
Совпадение user agent. Turnstile и ряд антибот-систем привязывают токен к user agent. Мы возвращаем использованный user agent, чтобы вы могли воспроизвести его в точности.
Запрашивайте как можно позже. Токены истекают примерно через 120 секунд. Запрашивайте токен, когда будете готовы к отправке.

Блокирующий вызов или опрос

В примере используется ?wait=60, поэтому вызов возвращает готовое решение, и шаг в cURL остаётся линейным. Если не хотите держать соединение, уберите параметр, сохраните полученный id и опрашивайте GET /v1/task/{id} каждые пять секунд. Оплаченный токен можно получить в течение десяти минут, так что обрыв соединения не стоит вам решения.

Стоимость

$0.00598 за каждое успешное решение reCAPTCHA v2; неудачные решения никогда не оплачиваются. Цены на все типы проверок — на странице цен, полный формат запроса — в справочнике API.

[ КАК ЭТО РАБОТАЕТ ]

Как решение встраивается в cURL

API работает на обычных HTTPS и JSON, поэтому cURL — самый быстрый способ увидеть решение от начала до конца ещё до написания кода.

01
Создайте ключ
Создайте API-ключ в личном кабинете. Он начинается с cn-.
02
Отправьте задачу
Отправьте POST с JSON, содержащим type, sitekey и url, на /v1/solve?wait=60 с заголовком Authorization: Bearer.
03
Прочитайте ответ
status, solution.token, cost и solveTime приходят в одном JSON-объекте.
04
Или опрашивайте
Уберите ?wait и опрашивайте GET /v1/task/{id} каждые несколько секунд.

Как передать токен на страницу

Вы копируете токен из JSON-ответа в поле формы или запрос, который отправляет ваш клиент.

[ ПОДВОДНЫЕ КАМНИ ]

Где интеграции обычно ломаются

Не указан Content-Type

Отправляйте Content-Type: application/json, иначе тело не будет разобрано.

Кавычки в оболочке

Заключайте JSON в одинарные кавычки, чтобы оболочка ничего внутри не раскрывала.

[ ВОПРОСЫ ]

Частые вопросы о капче в cURL

Нужен ли SDK?

Нет. CaptchaNo — обычный REST API. Подойдёт любой HTTP-клиент на любом языке, а cURL — самый простой способ попробовать.

Как проверить баланс?

Вызовите GET /v1/balance с тем же заголовком Authorization. Личный кабинет также показывает баланс, использование и каждое решение.

Что возвращает неудачное решение?

Статус failed с кодом ошибки. Неудачные решения не оплачиваются, поэтому повторять попытку безопасно.

Сколько можно ждать результата?

Параметр wait блокирует запрос до 120 секунд. Большинство решений возвращается гораздо раньше; используйте опрос, если ваш клиент не может так долго держать соединение.

[ ЧТО ПОЧИТАТЬ ]