API hCaptcha solver

POST

Состояние API

Состояние за 24 ч: Норма
Среднее время за 24 ч: —

Стабильно / норма
Доступно
Ограничено
Почти недоступно

Норма

Последние 24 часа

Последние 30 дней

API EverySolve для hCaptcha возвращает токен для вашего сценария прохождения проверки. Отправьте POST /api/v1/captcha, указав в type значение hcaptcha, и передайте входные данные, перечисленные ниже.hCaptcha — виджет h-captcha или явный вызов hcaptcha.render с собственным data-sitekey. API возвращает ответ hCaptcha в gRecaptchaResponse. Название поля не означает, что виджет — Google reCAPTCHA.

$4.58 за 1 000 успешных решений ($0.004583 за каждое успешное решение). Неудачные решения не оплачиваются.

Промпт для ИИ

Помогите мне написать скрипт, который вызывает API EveryInfra «hCaptcha».

Контракт API:
- Запрос: POST https://api.everyinfra.com/api/v1/captcha с заголовком Authorization: Bearer <API Key>. Берите ключ из переменной окружения EVERYINFRA_API_KEY, не указывайте его в коде.
- В теле запроса задайте для type значение hcaptcha, а параметры укажите рядом, на том же уровне.
- Обязательные параметры:
- website_url: Точный адрес страницы, на которой появляется проверка, включая нужный путь, а не только главную страницу сайта.
- website_key: Публичный ключ сайта или виджета, скопированный именно из этой интеграции на целевом сайте; это не секретный ключ.
- Необязательные параметры:
- invisible: Использует ли целевой виджет невидимый режим; не делайте вывод только по отсутствию изображения.
- Пример тела запроса:
{
"type": "hcaptcha",
"website_url": "<website_url>",
"website_key": "<website_key>"
}
- Оплата: $4.58 за 1 000 успешных решений ($0.004583 за каждое успешное решение). Неудачные решения не оплачиваются.
- При ошибке 422 исправьте параметры по подсказкам и допустимым значениям из ошибки. При 429 или 503 дождитесь истечения Retry-After и повторите попытку.

Прежде чем писать код, спросите меня, сколько записей нужно обработать и в каком формате сохранить результаты, затем согласуйте со мной план и примерную стоимость.

Параметры запроса

Имя	Расположение	Тип	Обязательный	По умолчанию	Описание
`Authorization`	header	`string`	Да	-	Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
`type`	body	`string`	Да	`hcaptcha`	Тип капчи, фиксированное значение.
`website_url`	body	`string`	Да	-	Точный адрес страницы, на которой появляется проверка, включая нужный путь, а не только главную страницу сайта.
`website_key`	body	`string`	Да	-	Публичный ключ сайта или виджета, скопированный именно из этой интеграции на целевом сайте; это не секретный ключ.
`invisible`	body	`boolean`	Нет	-	Использует ли целевой виджет невидимый режим; не делайте вывод только по отсутствию изображения.

Примеры кода

bash

curl -X POST 'https://api.everyinfra.com/api/v1/captcha' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "type": "hcaptcha",
  "website_url": "<website_url>",
  "website_key": "<website_key>"
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Предпросмотр полей

Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.

json

{
  "id": "req_…",
  "type": "hcaptcha",
  "solution": {
    "gRecaptchaResponse": "…"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Откуда брать параметры для hCaptcha

Скопируйте ключ сайта hCaptcha из виджета на целевом сайте и сохраните URL страницы, на которой этот виджет отображается.

Код для поиска этих значений на странице

hcaptcha-1.html

<div class="h-captcha" data-sitekey="your_site_key"></div>

hcaptcha-2.js

widgetId = hcaptcha.render('hcaptcha-container', {
  sitekey: 'your_site_key_here', size: 'invisible', callback: onSolve });

Как определить hCaptcha

hCaptcha — виджет h-captcha или явный вызов hcaptcha.render с собственным data-sitekey.

Чем hCaptcha отличается от других проверок

API возвращает ответ hCaptcha в gRecaptchaResponse. Название поля не означает, что виджет — Google reCAPTCHA.

Как использовать API для hCaptcha

API hCaptcha возвращает токен в gRecaptchaResponse. Формат решения: token. Передайте токен в поле либо в запросе проверки, как предусмотрено целевым сценарием.

01Выполните запрос GET /api/v1/captcha/types и выберите запись hcaptcha.
02Выполните POST /api/v1/captcha, передав type: "hcaptcha" и обязательные параметры.
03Получите токен из gRecaptchaResponse.
04Передайте токен в поле либо в запросе проверки, как предусмотрено целевым сценарием.

Оплата и доступность EverySolve списывает средства только при успешном предоставлении решения. За неудачную попытку итоговое списание не производится, а зарезервированная сумма возвращается автоматически. Получайте available и поля с ценами из GET /api/v1/captcha/types при отправке запроса, а не воспринимайте их как статические данные страницы.

Вопросы об интеграции hCaptcha

Как определить hCaptcha перед выбором типа?

hCaptcha — виджет h-captcha или явный вызов hcaptcha.render с собственным data-sitekey. Используйте hcaptcha, только если эти признаки соответствуют целевой проверке.

Какие значения с целевой страницы нужны в запросе для hCaptcha?

Скопируйте ключ сайта hCaptcha из виджета на целевом сайте и сохраните URL страницы, на которой этот виджет отображается. Передайте website_url и website_key. Необязательные параметры: invisible.

Что возвращает hCaptcha и с чем это не следует путать?

API hCaptcha возвращает токен в gRecaptchaResponse. Формат решения: token. API возвращает ответ hCaptcha в gRecaptchaResponse. Название поля не означает, что виджет — Google reCAPTCHA.

Какой внешний источник описывает интеграцию hCaptcha?

Официальная документация hCaptcha показывает интеграцию виджета, ключа сайта и токена ответа. [Открыть справку по hCaptcha](https://docs.hcaptcha.com/). Специфичные для EverySolve поля и текущую доступность по-прежнему смотрите в каталоге типов.

Справка по hCaptcha

Этот источник поясняет указанный тип капчи или термин веб-платформы. Он не означает, что получено разрешение или одобрение. В вопросах актуального формата запроса и ответа EverySolve, доступности и цен приоритет имеет публичный каталог типов.

Официальная документация hCaptcha показывает интеграцию виджета, ключа сайта и токена ответа. Этот источник подтверждает указанное рядом различие между продуктами, проверками или браузерными API. Актуальный формат запросов и ответов EverySolve определяет GET /api/v1/captcha/types.

Открыть справку по hCaptcha ↗

Все типы капчи

Ошибки и оплата

401: Ключ отсутствует или недействителен.
402: Недостаточно средств на балансе. Сначала пополните баланс.
422: Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429: Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503: Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто): Нет данных. Без списания.

Ошибки