Коды ошибок API
Если запрос не прошёл, API вместо ID задачи или ответа возвращает код ошибки. Ниже сначала самые частые коды и что с ними делать, затем полные таблицы для обоих форматов API: RuCaptcha (2Captcha) с in.php и res.php и Anti-Captcha с createTask и getTaskResult. Ищите код в разделе, который соответствует формату вашего софта.
Частые ошибки и как их исправить
CAPCHA_NOT_READY
На самом деле это не ошибка: капча ещё решается. Подождите 5–10 секунд и отправьте тот же запрос к res.php снова. Большинство капч готовы за несколько секунд, токены reCAPTCHA и Turnstile — за 10–30 секунд. Ограничьте общее время ожидания в коде (например, 2 минутами), чтобы задача не зависала бесконечно.
ERROR_WRONG_USER_KEY и ERROR_KEY_DOES_NOT_EXIST
Неверный API-ключ. ERROR_WRONG_USER_KEY приходит в формате RuCaptcha, ERROR_KEY_DOES_NOT_EXIST — в формате Anti-Captcha. Скопируйте ключ из личного кабинета ещё раз и проверьте, что в нём нет лишних пробелов или переносов строки, что он скопирован целиком и что вы передаёте его в нужном параметре: key для in.php и res.php, clientKey для createTask и getTaskResult.
ERROR_ZERO_BALANCE
Баланс нулевой или отрицательный. Пополните его в личном кабинете. Остаток можно узнать через API и прекращать отправку задач, когда он заканчивается, чтобы ваш софт не упирался в эту ошибку.
ERROR_CAPTCHA_UNSOLVABLE
Сервис не смог решить эту капчу. Обычно причина в том, что изображение нечитаемое, текст задания не совпадает с поддерживаемым или неверны параметры (sitekey, адрес страницы). Проверьте параметры и отправьте новую задачу. Повторять запрос с тем же ID задачи бессмысленно: получите на сайте новую капчу и отправьте её заново.
ERROR_NO_SLOT_AVAILABLE
Слишком много задач сразу или сервис сильно загружен. Подождите несколько секунд и отправьте задачу снова. Если ошибка повторяется часто, уменьшите число задач, которые вы отправляете одновременно.
ERROR_NO_SUCH_CAPCHA_ID и ERROR_WRONG_CAPTCHA_ID
ID задачи в запросе к res.php не найден. Проверьте, что вы передаёте ID точно в том виде, в каком его вернул in.php, и что результат запрашивается с тем же API-ключом, которым создавалась задача.
Формат RuCaptcha (2Captcha)
Ошибки
http://api.cap.guru/in.phpдля обычных капч
| Ошибка | Описание |
|---|---|
| ERROR_WRONG_USER_KEY | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_TOO_BIG_CAPTCHA_FILESIZE | Слишком большой файл изображения |
| ERROR_UPLOAD | Не удалось загрузить изображение |
| ERROR_CAPTCHA_UNSOLVABLE | Сервис не смог решить вашу капчу |
Ошибки
http://api.cap.guru/in.phpдля reCAPTCHA v2, невидимой v2 и v3
| Ошибка | Описание |
|---|---|
| ERROR_WRONG_USER_KEY | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_NO_SLOT_AVAILABLE | Нет свободных слотов: вы отправили слишком много задач или сервис сильно загружен |
| ERROR_PAGEURL | Неверный адрес страницы |
| ERROR_GOOGLEKEY | Неверный sitekey (googlekey) |
| ERROR_CAPTCHA_UNSOLVABLE | Сервис не смог решить вашу капчу |
Ошибки
http://api.cap.guru/res.php
| Ошибка | Описание |
|---|---|
| ERROR_WRONG_USER_KEY | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_GOOGLEKEY | Неверный sitekey (googlekey) |
| ERROR_CAPTCHA_UNSOLVABLE | Сервис не смог решить вашу капчу |
| CAPCHA_NOT_READY | Задача ещё решается, повторите запрос через 5–10 секунд |
| ERROR_NO_SUCH_CAPCHA_ID | ID задачи не найден |
| ERROR_WRONG_CAPTCHA_ID | ID задачи не найден |
| notpic | Объект из задания не найден на изображении |
Формат Anti-Captcha
Ошибки
http://api.cap.guru/createTaskдля картинок
| Ошибка | Описание |
|---|---|
| ERROR_KEY_DOES_NOT_EXIST | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_TOO_BIG_CAPTCHA_FILESIZE | Слишком большой файл изображения |
| ERROR_UPLOAD | Не удалось загрузить изображение |
| ERROR_IMAGE_TYPE_NOT_SUPPORTED | Формат изображения не поддерживается |
Ошибки
http://api.cap.guru/createTaskдля reCAPTCHA v2, невидимой v2 и v3
| Ошибка | Описание |
|---|---|
| ERROR_WRONG_USER_KEY | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_NO_SLOT_AVAILABLE | Нет свободных слотов: вы отправили слишком много задач или сервис сильно загружен |
| ERROR_RECAPTCHA_INVALID_DOMAIN | Неверный адрес страницы |
| ERROR_RECAPTCHA_INVALID_SITEKEY | Неверный sitekey |
| ERROR_CAPTCHA_UNSOLVABLE | Сервис не смог решить вашу капчу |
Ошибки
http://api.cap.guru/getTaskResult
| Ошибка | Описание |
|---|---|
| ERROR_KEY_DOES_NOT_EXIST | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_GOOGLEKEY | Неверный sitekey (googlekey) |
| ERROR_CAPTCHA_UNSOLVABLE | Сервис не смог решить вашу капчу |
| CAPCHA_NOT_READY | Задача ещё решается, повторите запрос через 5–10 секунд |
| ERROR_NO_SUCH_CAPCHA_ID | ID задачи не найден |
| ERROR_WRONG_CAPTCHA_ID | ID задачи не найден |
| notpic | Объект из задания не найден на изображении |
Ошибки методов, которые сейчас недоступны
Раскрыть
Эти коды относятся к решению hCaptcha и GeeTest токеном. Сейчас токеном эти капчи не решаются: hCaptcha и GeeTest решаются кликами. Коды оставлены для старых интеграций.
http://api.cap.guru/in.phpдля токенов hCaptcha
| Ошибка | Описание |
|---|---|
| ERROR_WRONG_USER_KEY | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_NO_SLOT_AVAILABLE | Нет свободных слотов: вы отправили слишком много задач или сервис сильно загружен |
| ERROR_PAGEURL | Неверный адрес страницы |
| ERROR_HKEY | Неверный sitekey hCaptcha |
| ERROR_CAPTCHA_UNSOLVABLE | Сервис не смог решить вашу капчу |
http://api.cap.guru/res.phpдля токенов hCaptcha
| Ошибка | Описание |
|---|---|
| ERROR_WRONG_USER_KEY | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_CAPTCHA_UNSOLVABLE | Сервис не смог решить вашу капчу |
| CAPCHA_NOT_READY | Задача ещё решается, повторите запрос через 5–10 секунд |
| ERROR_WRONG_CAPTCHA_ID | ID задачи не найден |
| notpic | Объект из задания не найден на изображении |
http://api.cap.guru/in.phpдля токенов GeeTest
| Ошибка | Описание |
|---|---|
| ERROR_WRONG_USER_KEY | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_NO_SLOT_AVAILABLE | Нет свободных слотов: вы отправили слишком много задач или сервис сильно загружен |
| ERROR_PAGEURL | Неверный адрес страницы |
| ERROR_CAPTCHA_UNSOLVABLE | Сервис не смог решить вашу капчу |
| ERROR_GEETTEST_GT | Пустое значение gt |
| ERROR_GEETTEST_challenge | Пустое значение challenge |
http://api.cap.guru/res.phpдля токенов GeeTest
| Ошибка | Описание |
|---|---|
| ERROR_WRONG_USER_KEY | Неверный API-ключ |
| ERROR_ZERO_BALANCE | Баланс нулевой или отрицательный, пополните его в личном кабинете |
| ERROR_CAPTCHA_UNSOLVABLE | Сервис не смог решить вашу капчу |
| CAPCHA_NOT_READY | Задача ещё решается, повторите запрос через 5–10 секунд |
| ERROR_WRONG_CAPTCHA_ID | ID задачи не найден |
| ERROR_CAPTCHA_BAD_GT_OR_CNANNEL | Неверное значение gt или channel |
| ERROR_PROXY_CONNECTION_FAILED | Прокси не работает |