Tokenwave EN Открыть бота

Жизненный цикл задачи

Как задача проходит путь от создания до результата и что происходит с деньгами на каждом этапе.

createTaskprocessingстоимость зарезервированарешеноreadyтокен живёт 60 сденьги списаныне решено или 5 минутERROR_CAPTCHA_UNSOLVABLEстоимость возвращенаERROR_* при createTaskзадача не создаётся, ничего не списано
Схема: путь задачи и движение денег

#Статусы

статус что значит деньги
processing задача принята и решается стоимость зарезервирована
ready решение готово, токен в solution остаются списанными
ошибка ERROR_CAPTCHA_UNSOLVABLE решить не удалось или вышло время стоимость возвращена

#Что проверяется при создании задачи

Метод createTask проверяет запрос по порядку и останавливается на первой ошибке. До проверки баланса задача не создаётся и ничего не списывается.

  1. Ключ существует — иначе ERROR_KEY_DOES_NOT_EXIST. Тело запроса, не являющееся корректным JSON, даёт ту же ошибку.
  2. Тип задачи поддерживается — иначе ERROR_TASK_NOT_SUPPORTED.
  3. Переданы websiteURL и websiteKey — иначе ERROR_BAD_PARAMETERS.
  4. Сайт разрешён — иначе ERROR_SITE_NOT_SUPPORTED.
  5. Ключ не отключён, на балансе достаточно средств, не превышен лимит задач — иначе ERROR_KEY_DISABLED, ERROR_ZERO_BALANCE или ERROR_NO_SLOT_AVAILABLE.
  6. Задача передана на решение — при сбое 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.Поддержка: кнопка «Помощь» в боте