NEWСтандартні API createTask та in.php. Змініть адресу, і ви підключені.Відкрити документацію API
GATESOLVER
Почати

Документація API

Запити у форматі JSON на одну адресу (https://gatesolver.com). Надсилайте API ключ, створений в акаунті, як clientKey. Створіть задачу (createTask) і за кілька секунд отримайте результат (getTaskResult).

Основна адреса
https://gatesolver.com
Автентифікація
clientKey у тілі запиту
Ліміт запитів
600 запитів за 1 хвилину на ключ
Формат
JSON (POST)

Почати

  1. Зареєструйтеся та поповніть баланс.
  2. Створіть ключ у меню API ключ в акаунті. Ключ показується лише один раз під час створення.
  3. Створіть задачу через createTask і кожні кілька секунд викликайте getTaskResult з отриманим taskId.
  4. Коли status стане ready, вставте solution на сторінку.

Клієнти, створені для формату createTask, працюють без змін після зміни адреси API. Нова адреса: https://gatesolver.com

createTask

POST https://gatesolver.com/createTask

Створює задачу і повертає taskId. На цьому етапі кошти не списуються.

ПолеФорматОбов'язковоОпис
clientKeystringТакAPI ключ
taskobjectТакДані задачі: type і поля для конкретного типу (див. таблицю type задач нижче та сторінки типів)
callbackUrlstringНіНе приймається. Отримуйте результат через getTaskResult.

Запит

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ReCaptchaV2TaskProxyLess",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
  }
}

Відповідь

{ "errorId": 0, "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" }

getTaskResult

POST https://gatesolver.com/getTaskResult

Повертає результат задачі. Для токенових CAPTCHA краще запитувати кожні 3 с, для розпізнавання зображень кожну 1 с. Вартість 1 задачі списується з балансу в момент, коли готова відповідь.

ПолеОпис
statusprocessing (очікування), ready (відповідь готова), failed (невдача, кошти не списуються)
solutionВідповідь. Поля залежать від типу (gRecaptchaResponse, token, cookie, text тощо)
costСума, списана за цю задачу (у доларах)
createTime / endTimeЧас створення і завершення (у мілісекундах)
{
  "errorId": 0,
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006",
  "status": "ready",
  "solution": { "gRecaptchaResponse": "03AFcWeA6...", "userAgent": "Mozilla/5.0 ..." },
  "cost": "0.000560"
}

getBalance

POST https://gatesolver.com/getBalance

Повертає баланс у доларах.

{ "clientKey": "YOUR_API_KEY" }

{ "errorId": 0, "balance": 42.5 }

type задачі

Назви type не чутливі до регістру. Поля та приклади для кожного типу є на сторінці цього типу.

typeТип1,000 задач
ReCaptchaV2TaskProxyLessreCAPTCHA v2$0.56
ReCaptchaV2TaskreCAPTCHA v2$0.56
ReCaptchaV2EnterpriseTaskProxyLessreCAPTCHA v2 Enterprise$0.70
ReCaptchaV2EnterpriseTaskreCAPTCHA v2 Enterprise$0.70
ReCaptchaV3TaskProxyLessreCAPTCHA v3$0.70
ReCaptchaV3TaskreCAPTCHA v3$0.70
ReCaptchaV3EnterpriseTaskProxyLessreCAPTCHA v3 Enterprise$2.10
ReCaptchaV3EnterpriseTaskreCAPTCHA v3 Enterprise$2.10
AntiTurnstileTaskProxyLessCloudflare Turnstile$0.84
TurnstileTaskProxylessCloudflare Turnstile$0.84
AntiCloudflareTaskCloudflare Challenge$0.84
AntiAwsWafTaskProxyLessAWS WAF$1.40
AntiAwsWafTaskAWS WAF$1.40
GeeTestTaskProxyLessGeeTest v3 / v4$0.84
GeeTestTaskGeeTest v3 / v4$0.84
MtCaptchaTaskProxyLessMTCaptcha$2.10
MtCaptchaTaskMTCaptcha$2.10
DatadomeSliderTaskDataDome Slider$1.75
ImageToTextTaskImage to Text$0.28
ReCaptchaV2ClassificationreCAPTCHA Image Classification$0.28
AwsWafClassificationAWS WAF Image Classification$0.42
VisionEngineVision Engine$1.05

Коди помилок

У разі помилки errorId дорівнює 1, і разом приходять errorCode та errorDescription. За відповіді з помилкою кошти не списуються.

errorCodeЗначення
ERROR_KEY_DENIED_ACCESSclientKey відсутній або неправильний.
ERROR_ZERO_BALANCEНедостатньо коштів на балансі. Поповніть і повторіть запит.
ERROR_TASK_NOT_SUPPORTEDЦей type задачі не підтримується.
ERROR_INVALID_TASK_DATAБракує обов'язкового поля. Назва поля вказана в errorDescription.
ERROR_TASKID_INVALIDtaskId не існує або створений не цим ключем.
ERROR_CAPTCHA_UNSOLVABLEНе вдалося розв'язати. Кошти не списано. Повторіть запит.
ERROR_SERVICE_UNAVAILABLEПомилка мережі. Кошти не списано. Повторіть запит трохи згодом.
ERROR_RATE_LIMITПеревищено 600 запитів за 1 хвилину. Збільште інтервал між запитами.
ERROR_ACCOUNT_SUSPENDEDАкаунт призупинено.

Сумісність з in.php

Для програм у стилі in.php достатньо змінити адресу. Підтримувані методи: userrecaptcha (reCAPTCHA v2), turnstile, geetest, base64 та post (текст зображення).

GET https://gatesolver.com/in.php?key=YOUR_API_KEY&method=userrecaptcha&googlekey=6Le...&pageurl=https://example.com
OK|61138bb6-19fb-11ec-a9c8-0242ac110006

GET https://gatesolver.com/res.php?key=YOUR_API_KEY&action=get&id=61138bb6-19fb-11ec-a9c8-0242ac110006
CAPCHA_NOT_READY
OK|03AFcWeA6...

GET https://gatesolver.com/res.php?key=YOUR_API_KEY&action=getbalance
42.50000

Якщо додати json=1, відповідь приходить у вигляді {"status":1,"request":"..."}.

Приклади

import requests, time

API, KEY = "https://gatesolver.com", "YOUR_API_KEY"

def solve(task, wait=3, timeout=120):
    r = requests.post(f"{API}/createTask", json={"clientKey": KEY, "task": task}, timeout=30).json()
    if r.get("errorId"):
        raise RuntimeError(r["errorCode"])
    end = time.time() + timeout
    while time.time() < end:
        time.sleep(wait)
        res = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": r["taskId"]}, timeout=30).json()
        if res.get("errorId"):
            raise RuntimeError(res["errorCode"])
        if res["status"] == "ready":
            return res["solution"]
    raise TimeoutError("task timed out")

print(solve({"type": "ReCaptchaV2TaskProxyLess", "websiteURL": "https://example.com", "websiteKey": "6Le..."}))