Главная›API

Коды ошибок

Любой ответ с ошибкой содержит errorId: 1, errorCode и текстовое описание errorDescription. HTTP-статус всегда 200.

json

{
  "errorId": 1,
  "errorCode": "ERROR_ZERO_BALANCE",
  "errorDescription": "Account has zero or negative balance."
}

Если ошибка повторяется и вы не можете исправить её сами, напишите в поддержку (кнопка Помощь в боте) и укажите taskId, время запроса и тело запроса без ключа.

#Сводная таблица

код	где возникает	деньги	повторять
`ERROR_KEY_DOES_NOT_EXIST`	любой метод	не списываются	нет, исправьте ключ
`ERROR_KEY_DISABLED`	`createTask`	не списываются	нет, напишите в поддержку
`ERROR_ZERO_BALANCE`	`createTask`	не списываются	после пополнения
`ERROR_NO_SLOT_AVAILABLE`	`createTask`	не списываются	да, когда часть задач завершится
`ERROR_TASK_NOT_SUPPORTED`	`createTask`	не списываются	нет, исправьте `type`
`ERROR_BAD_PARAMETERS`	`createTask`	не списываются	нет, добавьте параметры
`ERROR_SITE_NOT_SUPPORTED`	`createTask`	не списываются	нет
`ERROR_NO_SUCH_CAPCHA_ID`	`getTaskResult`	не списываются	нет
`ERROR_CAPTCHA_UNSOLVABLE`	`getTaskResult`	возвращаются	да, с новым `gid`
`ERROR_SERVICE_UNAVAILABLE`	`createTask`	возвращаются	да, через 5–30 секунд

#ERROR_KEY_DOES_NOT_EXIST

Когда возникает. Ключ clientKey не найден, указан с ошибкой или не передан. Такую же ошибку вернёт запрос, тело которого не является корректным JSON.

Что делать. Возьмите ключ в боте (Мой ключ) и убедитесь, что скопировали его целиком, без пробелов.

json

{
  "errorId": 1,
  "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
  "errorDescription": "Account authorization key not found in the system."
}

#ERROR_KEY_DISABLED

Когда возникает. Ключ отключён администратором, например при нарушении правил. Ошибка возвращается при создании задачи; getBalance продолжает отвечать.

Что делать. Напишите в поддержку.

json

{
  "errorId": 1,
  "errorCode": "ERROR_KEY_DISABLED",
  "errorDescription": "Account is disabled."
}

#ERROR_ZERO_BALANCE

Когда возникает. Баланс меньше стоимости одной задачи. Помните, что стоимость задач в работе уже вычтена из баланса.

Что делать. Пополните баланс в боте. Текущее значение показывает getBalance.

json

{
  "errorId": 1,
  "errorCode": "ERROR_ZERO_BALANCE",
  "errorDescription": "Account has zero or negative balance."
}

#ERROR_NO_SLOT_AVAILABLE

Когда возникает. На ключе уже 600 задач в работе — это предел одновременных задач.

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

json

{
  "errorId": 1,
  "errorCode": "ERROR_NO_SLOT_AVAILABLE",
  "errorDescription": "Too many parallel tasks, try again later."
}

#ERROR_TASK_NOT_SUPPORTED

Когда возникает. В task.type указан неподдерживаемый тип, либо task не передан или не является объектом.

Что делать. Используйте HCaptchaTask или HCaptchaTaskProxyless и передавайте task объектом.

json

{
  "errorId": 1,
  "errorCode": "ERROR_TASK_NOT_SUPPORTED",
  "errorDescription": "Task type is not supported."
}

#ERROR_BAD_PARAMETERS

Когда возникает. В задаче нет websiteURL или websiteKey.

Что делать. Передайте оба поля. Адрес указывайте полностью, вместе с https://.

json

{
  "errorId": 1,
  "errorCode": "ERROR_BAD_PARAMETERS",
  "errorDescription": "Required parameters are missing or invalid."
}

#ERROR_SITE_NOT_SUPPORTED

Когда возникает. Хост из websiteURL не входит в список разрешённых: store.steampowered.com, steamcommunity.com, help.steampowered.com.

Что делать. Проверьте адрес страницы. Другие сайты не поддерживаются.

json

{
  "errorId": 1,
  "errorCode": "ERROR_SITE_NOT_SUPPORTED",
  "errorDescription": "This website is not supported."
}

#ERROR_NO_SUCH_CAPCHA_ID

Когда возникает. Задачи с таким taskId нет среди задач вашего ключа: идентификатор неверный, чужой, не число или задача уже удалена (хранится 5 минут).

Что делать. Передавайте taskId из ответа createTask и запрашивайте результат в течение 5 минут.

json

{
  "errorId": 1,
  "errorCode": "ERROR_NO_SUCH_CAPCHA_ID",
  "errorDescription": "Task not found."
}

#ERROR_CAPTCHA_UNSOLVABLE

Когда возникает. Капчу решить не удалось: параметры устарели или неверны (чаще всего использованный или просроченный gid), временный сбой, либо результат не готов за 5 минут. Стоимость задачи возвращается.

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

json

{
  "errorId": 1,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
  "errorDescription": "The captcha could not be solved. This is usually a temporary condition, try again."
}

#ERROR_SERVICE_UNAVAILABLE

Когда возникает. Задачу не удалось передать на решение из-за временного сбоя. Стоимость возвращается, задача не создаётся.

Что делать. Повторите createTask через 5–30 секунд с теми же параметрами.

json

{
  "errorId": 1,
  "errorCode": "ERROR_SERVICE_UNAVAILABLE",
  "errorDescription": "Service is temporarily unavailable, try again later."
}