Методы
В API три POST-метода: createTask отправляет капчу на решение, getTaskResult возвращает решение, getBalance показывает баланс аккаунта. Каждый запрос — JSON-тело с clientKey.
POST /createTask
Создаёт задачу на решение капчи и возвращает её taskId. Цена типа задачи резервируется на балансе и списывается только если задача решена.
Запрос
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6Le-xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
Ответ
{
"errorId": 0,
"taskId": 100
}
Поддерживаемые типы задач. В v1 поддерживаются токен-капчи, proxyless или с вашим прокси:
RecaptchaV2TaskProxyless // reCAPTCHA v2
RecaptchaV3TaskProxyless // reCAPTCHA v3 (websiteKey + minScore, pageAction)
TurnstileTaskProxyless // Cloudflare Turnstile
RecaptchaV2Task // reCAPTCHA v2 (ваш прокси)
TurnstileTask // Cloudflare Turnstile (ваш прокси)
Типы без суффикса Proxyless решаются через ваш прокси и требуют proxyType (http, socks4 или socks5), proxyAddress и proxyPort. Опционально: proxyLogin и proxyPassword (для прокси с авторизацией) и userAgent.
reCAPTCHA v2
Типы RecaptchaV2TaskProxyless и RecaptchaV2Task. Опциональное поле: isInvisible (true для невидимой reCAPTCHA). Ключ решения — gRecaptchaResponse.
Примеры объекта task
// RecaptchaV2TaskProxyless
{
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6Le-xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"isInvisible": false
}
// RecaptchaV2Task (ваш прокси)
{
"type": "RecaptchaV2Task",
"websiteURL": "https://example.com/login",
"websiteKey": "6Le-xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"proxyType": "http",
"proxyAddress": "1.2.3.4",
"proxyPort": 8080,
"proxyLogin": "user",
"proxyPassword": "password",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ..."
}
reCAPTCHA v3
Тип RecaptchaV3TaskProxyless. Обязательное поле: minScore (минимально допустимый score, например 0.3); опциональное: pageAction. Прокси для v3 не требуется: задачи решаются с IP-адресов сервиса. Ключ решения — gRecaptchaResponse.
Примеры объекта task
// RecaptchaV3TaskProxyless
{
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6Le-xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"minScore": 0.3,
"pageAction": "login"
}
Cloudflare Turnstile
Типы TurnstileTaskProxyless и TurnstileTask. Дополнительных полей нет. Ключ решения — token.
Примеры объекта task
// TurnstileTaskProxyless
{
"type": "TurnstileTaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "0x4AAAAAAAxxxxxxxxxxxxxxxx"
}
// TurnstileTask (ваш прокси)
{
"type": "TurnstileTask",
"websiteURL": "https://example.com/login",
"websiteKey": "0x4AAAAAAAxxxxxxxxxxxxxxxx",
"proxyType": "http",
"proxyAddress": "1.2.3.4",
"proxyPort": 8080
}
POST /getTaskResult
Возвращает статус задачи. Пока идёт решение, статус будет processing; когда готово — ready, а в solution лежит токен. Если решить не удалось, возвращается ошибка, а зарезервированные средства возвращаются на баланс.
Запрос
{
"clientKey": "YOUR_API_KEY",
"taskId": 100
}
Ответ
{ "errorId": 0, "status": "processing" }
// reCAPTCHA v2 / v3
{
"errorId": 0,
"status": "ready",
"solution": { "gRecaptchaResponse": "03AGdBq..." }
}
// Turnstile
{
"errorId": 0,
"status": "ready",
"solution": { "token": "0.zxcv..." }
}
Ключ в solution зависит от типа капчи: gRecaptchaResponse для reCAPTCHA v2/v3, token для Turnstile.
POST /getBalance
Возвращает текущий доступный баланс аккаунта.
Запрос
{ "clientKey": "YOUR_API_KEY" }
Ответ
{ "errorId": 0, "balance": 12.34 }