Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API reCAPTCHA v3 solver

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

API EverySolve для reCAPTCHA v3 возвращает токен для вашего сценария прохождения проверки. Отправьте POST /api/v1/captcha, указав в type значение recaptcha_v3, и передайте входные данные, перечисленные ниже.reCAPTCHA v3 основана на оценке и обычно работает через grecaptcha.execute без показа чекбокса v2. EverySolve возвращает gRecaptchaResponse, а не оценку Google. Токен и действие проверяет бэкенд защищённого сайта.

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

Промпт для ИИ

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

Контракт API:
- Запрос: POST https://api.everyinfra.com/api/v1/captcha с заголовком Authorization: Bearer <API Key>. Берите ключ из переменной окружения EVERYINFRA_API_KEY, не указывайте его в коде.
- В теле запроса задайте для type значение recaptcha_v3, а параметры укажите рядом, на том же уровне.
- Обязательные параметры:
  - website_url: Точный адрес страницы, на которой появляется проверка, включая нужный путь, а не только главную страницу сайта.
  - website_key: Публичный ключ сайта или виджета, скопированный именно из этой интеграции на целевом сайте; это не секретный ключ.
- Необязательные параметры:
  - page_action: Строка действия, которая используется при выполнении целевой reCAPTCHA; сохраняйте точный регистр и написание.
  - min_score: Запрошенное пороговое значение оценки reCAPTCHA v3; это ограничение, а не гарантированная оценка или доля успешных решений. (допустимые значения: 0.3 / 0.7 / 0.9)
  - api_domain: Имя хоста API, которое использует целевой виджет, если оно отличается от стандартного домена. (допустимые значения: www.google.com / www.recaptcha.net)
  - invisible: Использует ли целевой виджет невидимый режим; не делайте вывод только по отсутствию изображения.
  - enterprise_payload: Данные страницы для Enterprise, которые передаёт интеграция reCAPTCHA на целевом сайте, если они есть.
- Пример тела запроса:
{
  "type": "recaptcha_v3",
  "website_url": "<website_url>",
  "website_key": "<website_key>"
}
- Оплата: $1.39 за 1 000 успешных решений ($0.001389 за каждое успешное решение). Неудачные решения не оплачиваются.
- При ошибке 422 исправьте параметры по подсказкам и допустимым значениям из ошибки. При 429 или 503 дождитесь истечения Retry-After и повторите попытку.

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

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

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
typebodystringДаrecaptcha_v3Тип капчи, фиксированное значение.
website_urlbodystringДа-Точный адрес страницы, на которой появляется проверка, включая нужный путь, а не только главную страницу сайта.
website_keybodystringДа-Публичный ключ сайта или виджета, скопированный именно из этой интеграции на целевом сайте; это не секретный ключ.
page_actionbodystringНет-Строка действия, которая используется при выполнении целевой reCAPTCHA; сохраняйте точный регистр и написание.
min_scorebodynumber (enum)Нет-Запрошенное пороговое значение оценки reCAPTCHA v3; это ограничение, а не гарантированная оценка или доля успешных решений.Допустимые значения0.30.70.9
api_domainbodystring (enum)Нет-Имя хоста API, которое использует целевой виджет, если оно отличается от стандартного домена.Допустимые значенияwww.google.comwww.recaptcha.net
invisiblebodybooleanНет-Использует ли целевой виджет невидимый режим; не делайте вывод только по отсутствию изображения.
enterprise_payloadbodyobjectНет-Данные страницы для Enterprise, которые передаёт интеграция reCAPTCHA на целевом сайте, если они есть.

Примеры кода

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": "recaptcha_v3",
  "website_url": "<website_url>",
  "website_key": "<website_key>"
}'

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

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

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

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

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

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

Скопируйте website_key из значения render в api.js и сохраните точный page_action; min_score — ограничение запроса, а не оценка, которую гарантирует целевой сайт.

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

recaptcha_v3-1.js
grecaptcha.ready(function () {
  grecaptcha.execute('<sitekey>', {action: 'submit'}).then(function (token) { … });
});
recaptcha_v3-2.js
const _x = grecaptcha.execute;
grecaptcha.execute = (k, o) => { console.log('sitekey:', k, 'opts:', o); return _x(k, o); };

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

reCAPTCHA v3 основана на оценке и обычно работает через grecaptcha.execute без показа чекбокса v2.

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

EverySolve возвращает gRecaptchaResponse, а не оценку Google. Токен и действие проверяет бэкенд защищённого сайта.

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

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

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

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

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

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

reCAPTCHA v3 основана на оценке и обычно работает через grecaptcha.execute без показа чекбокса v2. Используйте recaptcha_v3, только если эти признаки соответствуют целевой проверке.

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

Скопируйте website_key из значения render в api.js и сохраните точный page_action; min_score — ограничение запроса, а не оценка, которую гарантирует целевой сайт. Передайте website_url и website_key. Необязательные параметры: page_action, min_score, api_domain, invisible и enterprise_payload.

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

API reCAPTCHA v3 возвращает токен в gRecaptchaResponse. Формат решения: token. EverySolve возвращает gRecaptchaResponse, а не оценку Google. Токен и действие проверяет бэкенд защищённого сайта.

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

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

Справка по reCAPTCHA v3

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

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

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

Ошибки