Главная›API
Жизненный цикл задачи
Как задача проходит путь от создания до результата и что происходит с деньгами на каждом этапе.
#Статусы
| статус | что значит | деньги |
|---|---|---|
processing |
задача принята и решается | стоимость зарезервирована |
ready |
решение готово, токен в solution |
остаются списанными |
ошибка ERROR_CAPTCHA_UNSOLVABLE |
решить не удалось или вышло время | стоимость возвращена |
#Что проверяется при создании задачи
Метод createTask проверяет запрос по порядку и останавливается на первой ошибке. До проверки баланса задача не создаётся и ничего не списывается.
- Ключ существует — иначе
ERROR_KEY_DOES_NOT_EXIST. Тело запроса, не являющееся корректным JSON, даёт ту же ошибку. - Тип задачи поддерживается — иначе
ERROR_TASK_NOT_SUPPORTED. - Переданы
websiteURLиwebsiteKey— иначеERROR_BAD_PARAMETERS. - Сайт разрешён — иначе
ERROR_SITE_NOT_SUPPORTED. - Ключ не отключён, на балансе достаточно средств, не превышен лимит задач — иначе
ERROR_KEY_DISABLED,ERROR_ZERO_BALANCEилиERROR_NO_SLOT_AVAILABLE. - Задача передана на решение — при сбое
ERROR_SERVICE_UNAVAILABLE, стоимость возвращается.
#Сроки
| этап | срок |
|---|---|
| решение | обычно 15–60 секунд |
| ожидание результата | до 5 минут, затем задача закрывается ошибкой ERROR_CAPTCHA_UNSOLVABLE |
| использование токена | 60 секунд после того, как статус стал ready |
| хранение задачи | 5 минут, после этого getTaskResult вернёт ERROR_NO_SUCH_CAPCHA_ID |
#Как правильно повторять запросы
getTaskResultповторяйте каждые 2–3 секунды, пока статусprocessing.ERROR_CAPTCHA_UNSOLVABLE: получите новыйgidи создайте новую задачу. Старую задачу повторить нельзя.ERROR_SERVICE_UNAVAILABLE: повторитеcreateTaskчерез 5–30 секунд, параметры можно оставить прежними.- Не повторяйте
createTask«на всякий случай», пока не получили ответ: каждая создаваемая задача резервирует деньги и считается отдельной.
© Tokenwave. Решение hCaptcha для Steam.Поддержка: кнопка «Помощь» в боте