Документация

Документация для решения TextCaptcha

1. Создание задачи TextCaptcha

Чтобы создать задачу TextCaptcha, отправьте POST-запрос на адрес http://api.botlab.me/create с указанием API-ключа в заголовке X-API-Key. В теле запроса передайте данные в формате JSON.

Запрос

  • URL: http://api.botlab.me/create
  • Метод: POST
  • Заголовок: X-API-Key: API KEY
  • Content-Type: application/json

Тело запроса (JSON):

  • type - * Обязательно. Тип задачи, в данном случае "TextCaptcha"
  • task - * Обязательно. Картинка капчи в формате Base64.
  • app_id - Идентификатор приложения разработчика (можно найти в разделе реферальная система для разработчиков)
{	
	
	  "type": "TextCaptcha",
	  "task": "TASK_BASE_64"
}

Ответ

После успешного создания задачи получите уникальный идентификатор задачи.

{
  "status": 1,
  "response": "9051d4b4-0000-44d3-a4c2-db0215227862"
}

• status - статус выполнения запроса (1 - успешно, 0 - ошибка). • response - идентификатор задания / код ошибки

2. Получение результатов задачи TextCaptcha

Чтобы получить результаты обработки задачи TextCaptcha, отправьте POST-запрос на адрес http://api.botlab.me/result с указанием API-ключа в заголовке X-API-Key. В теле запроса передайте идентификатор задачи из предыдущего запроса.

Запрос

  • URL: http://api.botlab.me/result
  • Метод: POST
  • Заголовок: X-API-Key: API KEY

Тело запроса (JSON): • id - идентификатор созданной задачи

{
	  "id": "9051d4b4-0000-44d3-a4c2-db0215227862"
}

Ответ

Получите результаты обработки задачи TextCaptcha в виде словосочетания.

{
  "status": 1,
  "response": "12"
}

• status - статус выполнения запроса (1 - успешно, 0 - ошибка). • response - число шага, где пазл сложен / код ошибки.

Если в ответе вы получаете значение CAPCHA_NOT_READY, это означает, что результаты еще не готовы. В таком случае, рекомендуется подождать до 5 секунд и повторить запрос на получение результатов. Повторяйте запрос, пока не получите успешный результат (status равен 1) или другой статус, указывающий на ошибку.

Для владельцев своего софта

После регистрации приложение вы получите свой softId, на создание задачи щлем POST-запрос на адрес http://api.botlab.me/create

{
  "type": "TextCaptcha",
  "task": "TASK_BASE_64",
  "app_id": "идентификатор приложения"
}