Документация
Всё, что нужно, чтобы отправить первое решение и добиться его принятия.
Первое решение за четыре шага
- 01Создайте аккаунт
Зарегистрируйтесь и подтвердите email. Новые аккаунты получают 0,10 $ бесплатного баланса, карта не нужна.
- 02Создайте API-ключ
В личном кабинете, в разделе Keys. Ключи начинаются с cn- и показываются один раз, поэтому сохраните свой в надёжном месте.
- 03Отправьте задачу на решение
Отправьте POST с type, sitekey и URL страницы на /v1/solve?wait=60 с заголовком Authorization: Bearer cn-…
- 04Отправьте токен
Поместите токен туда, где его ожидает страница, и отправьте форму примерно в течение двух минут.
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 }Выберите интеграцию
Рабочие примеры с реальным API и подводные камни, характерные для каждого инструмента.
Добейтесь принятия токенов
Большинство случаев, когда валидный токен отклоняется, сводится к одной из этих причин.
Самая частая причина отклонения — токен получен с другого IP или в другом браузере, чем те, с которых он отправляется.
Для reCAPTCHA v3 передавайте то же имя action, что использует страница. Несовпадение незаметно снижает оценку.
Токены истекают примерно через две минуты и одноразовы. Решайте капчу непосредственно перед отправкой и заново при каждой повторной попытке.
Блокирующий вызов или опрос
С ?wait=N (до 120 секунд) запрос на решение ожидает, пока результат не будет готов. Без него вы сразу получаете id задачи и опрашиваете GET /v1/task/{id} каждые пять секунд. Оплаченное решение можно получить в течение десяти минут, поэтому обрыв соединения не стоит вам решения.
Оплата
Плата взимается только за успешные решения; неудачные бесплатны. В каждом ответе указана его стоимость cost, а GET /v1/balance возвращает остаток баланса. Ставки по типам — на странице цен.
Ключи и команды
В аккаунте может быть до десяти активных ключей. Называйте их по проектам или клиентам — личный кабинет показывает использование по каждому ключу; отзыв одного ключа не влияет на остальные.
Частые вопросы о документации
Есть ли официальный SDK?
Да. SDK с открытым исходным кодом для Python, Node.js и TypeScript, Go и PHP доступны на GitHub. Но они не обязательны: CaptchaNo — это обычный REST API с JSON на входе и выходе, поэтому подойдёт любой HTTP-клиент, а в руководствах по интеграции показаны несколько нужных строк для каждого языка и инструмента.
Какие типы проверок поддерживаются?
reCAPTCHA v2 (чекбокс и невидимая), reCAPTCHA v3, виджеты reCAPTCHA Enterprise в стиле чекбокса, Cloudflare Turnstile, DataDome и капчи-картинки или текстовые капчи — всё через один формат запроса.
Нужен ли прокси?
Для DataDome — да, потому что cookie привязана к IP, который её получил. Для проверок с токенами прокси необязателен, но повышает долю принятых токенов, поскольку сайт может сравнить, где токен был получен и откуда он отправлен.
Что происходит, если решение не удалось?
Задача завершается со статусом failed и кодом ошибки, а плата не взимается. Повторите попытку с новым запросом.
Где посмотреть статистику использования?
В личном кабинете перечислены все решения с типом, длительностью, стоимостью и ключом, а также показаны баланс и расходы по каждому ключу.
Полезные руководства
Готовы начать?
Начните с бесплатного 3-дневного пробного периода, а по мере роста трафика платите за каждое успешное решение. Для пробного периода карта не нужна.