CapMonster Cloud API

Решение капчи через API CapMonster Cloud

Решение капчи через API — это автоматическое выполнение задач по распознаванию и разгадыванию слов или символов через специальные интерфейсы. С помощью CapMonster Cloud можно автоматизировать обход CAPTCHA, упростить и ускорить работу.

Механизм работы

API выполняет свою основную задачу по решению капчи согласно следующей схеме:

1. Отправка

Клиент отправляет запрос на сервер API, передавая данные CAPTCHA (изображение, ключи сайта, URL).

2. Обработка

Сервер API принимает запрос, распознает капчу и начинает ее решать.

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

Сервер API решает капчу, и клиент осуществляет дальнейшие действия для подтверждения проверки.

Для чего используют API для решения капч

API (программные интерфейсы приложений) используются для автоматизации действий на сайте.

Прохождения регистрации

Получения и копирования данных

Отправки той или иной информации на сервер

Автоматическое решение капчи через API

API Capmonster Cloud использует стандартные HTTP-запросы с данными, передаваемыми в формате JSON.

Адреса методов API

createTask
Используется для формирования задачи по решению капчи.
JSON POST
```
https://api.capmonster.cloud/createTask
```
getTaskResult
Применяется для проверки статуса (получения ответа по задаче).
JSON POST
```
https://api.capmonster.cloud/getTaskResult
```
getBalance
Используется для получения информации о текущем балансе аккаунта.
JSON POST
```
https://api.capmonster.cloud/getBalance
```
getUserAgent
Применяется для получения актуальных данных о браузере и операционной системе.
JSON POST
```
https://capmonster.cloud/api/useragent/actual
```

Алгоритм решения captcha

Получение ключа

Для начала получите свой уникальный API-ключ в личном кабинете CapMonster Cloud.

Отправка запроса для создания задачи

Отправьте HTTP POST запрос на адрес:

https://api.capmonster.cloud/createTask

В запросе укажите ваш API-ключ и данные о задаче.

Как должен выглядеть ваш запрос:

{
  "clientKey":"API_KEY",
  "task": {
    "type":"RecaptchaV2TaskProxyless",
    "websiteURL":"https://example.com/",
    "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  }
}

Сервер вернет идентификатор CAPTCHA (taskId) или отправит код ошибки, если что-то пойдет не так.

Получение ответа

После создания задачи отправьте запрос для получения ответа на адрес:

https://api.capmonster.cloud/getTaskResult

Укажите ваш API-ключ и идентификатор задачи (taskId).

Как должен выглядеть ваш запрос:

{
  "clientKey":"API_KEY",
  "taskId":12345678
}

Сервер решит капчу или предоставит информацию о том, что задача еще в процессе.

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

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "gRecaptchaResponse":"response_token" 
  }
}

Обработки ошибок. Основные виды и инструкции по устранению

Основные ошибки, с которыми вы можете столкнуться:

INVALID KEY

Код ошибки в API: ERROR_KEY_DOES_NOT_EXIST

Это уведомление указывает на то, что введен неправильный или несуществующий ключ API. Проверьте, правильно ли вы его написали, и попробуйте еще раз.

NO FUNDS

Код ошибки в API: ERROR_ZERO_BALANCE

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

BIG IMAGE SIZE

Код ошибки в API: ERROR_TOO_BIG_CAPTCHA_FILESIZE

Это уведомление указывает на то, что размер капчи превышен.

ZERO IMAGE SIZE

Код ошибки в API: ERROR_ZERO_CAPTCHA_FILESIZE

Это уведомление указывает на то, что размер изображения, которое вы загружаете менее 100 байт.

CAPTCHA ID IS NOT FOUND

Код ошибки в API: ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID

Капча не обнаружена в системе (не найден ее айди). Статус капчи нужно проверять в течение первых 5 минут после отправки данных. Убедитесь, что вы проверили его за этот временной промежуток.

CAPTCHA UNSOLVABLE

Код ошибки в API: ERROR_CAPTCHA_UNSOLVABLE

Данный тип капч не поддерживается сервисом или картинка не содержит ответа, то есть является шумом. Возможно, она является поврежденной или неправильно отрисованной.

CAPTCHA IS NOT READY

Код ошибки в API: CAPTCHA_NOT_READY

Капча еще не решена. Просто подождите минуту или две.

REQUEST IS NOT ALLOWED FROM YOUR IP

Код ошибки в API: ERROR_IP_NOT_ALLOWED

Данное уведомление указывает на то, что запрос с этого айпи-адреса отклонен. Откройте личный кабинет и зайдите в его настройки , а затем добавьте собственный IP в список доверенных.

IP BANNED

Код ошибки в API: ERROR_IP_BANNED

Вами был превышен лимит запросов с учетом неправильного API-ключа. Проверьте ключ и снова попробуйте создать задачу.

INCORRECT METHOD

Код ошибки в API: ERROR_NO_SUCH_METHOD

Неправильно указана captcha (значение параметра «type»). Проверьте правильность используемого метода.

THE TOKEN IS EXPIRED

Код ошибки в API: ERROR_TOKEN_EXPIRED

При распознавании (разгадывании) капчи ее провайдер заметил, что истек срок действия дополнительного токена. Создайте новую задачу, получите новый токен и повторите запрос.

NO FREE SERVERS

Код ошибки в API: ERROR_NO_SLOT_AVAILABLE

Все сервера заняты. Повторите попытку позже.

INVALID RECAPTCHA SITEKEY

Код ошибки в API: ERROR_RECAPTCHA_INVALID_SITEKEY

Передан неверный ключ для reCAPTCHA. Проверьте правильность sitekey.

RECAPTCHA TIMEOUT

Код ошибки в API: ERROR_RECAPTCHA_TIMEOUT

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

YOUR IP IS BLOCKED

Код ошибки в API: ERROR_IP_BLOCKED

Доступ с указанного IP-адреса запрещен из-за большого количества ошибок. Проверьте частоту ваших запросов. Смените IP. Учитывайте ограничения при создании задач.

FAILED TO CONNECT PROXY

Код ошибки в API: ERROR_PROXY_CONNECT_REFUSED

Сервис не может установить соединение через указанный прокси-сервер. Проверьте правильность настроек прокси (IP, порт, логин, пароль) и его доступность. Воспользуйтесь другим.

THE PROXY IP IS BANNED

Код ошибки в API: ERROR_PROXY_BANNED

Прокси был заблокирован на целевом сервисе капчи по айпи. Воспользуйтесь другим.

ERROR_TASK_ABSENT

Код ошибки в API: ERROR_TASK_ABSENT

Объект task не был обнаружен или отправлен невалидный JSON. Убедитесь, что все сделали правильно. Проверьте, не истек ли срок выполнения задачи.

Не забывайте сверяться с документацией, чтобы применять только актуальные параметры и методы API.

Важно! У вас появилась другая ошибка, и вы не знаете, как ее устранить? Ознакомьтесь со следующей инструкцией, которая поможет вам справиться с проблемой: https://docs.capmonster.cloud/ru/docs/api/api-errors/.