reCAPTCHA V3 Enterprise

reCAPTCHA V3 Enterprise — корпоративная версия score-based защиты Google: та же фоновая проверка без взаимодействия с пользователем, но с усиленными ML-моделями и обязательным возвратом User-Agent решателя вместе с токеном. Подключается через enterprise.js, а не обычный api.js.

Формат запроса

GET/in.php

keystringобязателен

Ваш API-ключ (32 символа)

methodstringобязателен

Значение: userrecaptcha

versionstringобязателен

Значение: v3

googlekeystringобязателен

Sitekey из render= параметра enterprise.js

pageurlstringобязателен

Полный URL-адрес, на котором отображается reCAPTCHA

enterpriseintegerобязателен

Обязательно 1

actionstringпо умолчанию: verifyопционально

Значение из вызова grecaptcha.enterprise.execute()

proxystringопционально

Формат: login:password@123.123.123.123:3128

proxytypestringопционально

Тип прокси: HTTP, HTTPS, SOCKS4, SOCKS5

cookiesstringопционально

Формат: KEY1:Value1;KEY2:Value2;

userAgentstringопционально

User-Agent, передаваемый в браузер решателя

jsoninteger (0/1)по умолчанию: 0опционально

Используйте 1 — иначе не получите user_agent

Как решать капчу

Шаг 1. Найдите enterprise-параметры

• Найдите загрузку https://www.google.com/recaptcha/enterprise.js?render=SITEKEY — извлеките sitekey из render=
• Найдите значение action в вызове grecaptcha.enterprise.execute() (например, login)

Шаг 2. Отправьте задачу нам

cURL

curl -G "https://captcha-api.iwhat.pw/in.php" \
  -d key=YOUR_API_KEY \
  -d method=userrecaptcha \
  -d version=v3 \
  -d googlekey=6LgP2VwbAAAAAF7mZtQx4RcNoYl9KdWjHu6BsErA \
  -d pageurl=https://example.com/page \
  -d enterprise=1 \
  -d action=login \
  -d json=1

Python

import requests

params = {
    'key': 'YOUR_API_KEY',
    'method': 'userrecaptcha',
    'version': 'v3',
    'googlekey': '6LgP2VwbAAAAAF7mZtQx4RcNoYl9KdWjHu6BsErA',
    'pageurl': 'https://example.com/page',
    'enterprise': '1',
    'action': 'login',
    'json': '1'
}

response = requests.get('https://captcha-api.iwhat.pw/in.php', params=params)
result = response.json()
task_id = result['request']
print(f"ID задачи: {task_id}")

JavaScript

const params = new URLSearchParams({
  key: 'YOUR_API_KEY',
  method: 'userrecaptcha',
  version: 'v3',
  googlekey: '6LgP2VwbAAAAAF7mZtQx4RcNoYl9KdWjHu6BsErA',
  pageurl: 'https://example.com/page',
  enterprise: '1',
  action: 'login',
  json: '1',
});

const res = await fetch(`https://captcha-api.iwhat.pw/in.php?${params}`);
const { request: taskId } = await res.json();
console.log(`ID задачи: ${taskId}`);

Шаг 3. Получение решения

import time

time.sleep(20)

result = requests.get('https://captcha-api.iwhat.pw/res.php', params={
    'key': 'YOUR_API_KEY',
    'action': 'get',
    'id': task_id,
    'json': '1',
}).json()

if result['status'] == 1:
    token = result['result']
    user_agent = result['user_agent']
    print(f"Токен: {token}")
    print(f"User-Agent: {user_agent}")

Шаг 4. Отправьте токен с бэкенда

response = requests.post('https://example.com/api/login', data={
    'username': 'user@example.com',
    'password': 'password123',
    'g-recaptcha-response': token,
}, headers={'User-Agent': user_agent})

Формат ответа

JSON-ответ (при json=1):

{
  "status": 1,
  "result": "0kTmYq2WcXfB8sNrJoV3ZdLp1GhEnUaM6...",
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)..."
}

Распространённые ошибки

Код	Описание
ERROR_WRONG_USER_KEY	Неверный формат API-ключа
ERROR_KEY_DOES_NOT_EXIST	Такого API-ключа не существует
ERROR_ZERO_BALANCE	Недостаточно средств на балансе
ERROR_PAGEURL	Отсутствует параметр pageurl
ERROR_WRONG_GOOGLEKEY	sitekey пустой или в неверном формате
CAPCHA_NOT_READY	Решение ещё не готово, подождите 5 сек

Советы и рекомендации

• Всегда запрашивайте json=1 — иначе не получите user_agent, без которого токен не пройдёт проверку
• Несовпадение User-Agent между получением решения и отправкой токена — частая причина провала валидации
• Надёжный score держится примерно до 0.7; для более высоких значений может понадобиться повтор