Как жаловаться на плохие токены

Зачем жаловаться?

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


Адреса методов:

https://api.capmonster.cloud/reportIncorrectImageCaptcha - для жалоб на капчи-картинки

https://api.capmonster.cloud/reportIncorrectTokenCaptcha - для жалоб на токен-капчи: recaptcha(2,3, enterprise), hcaptcha, geetest, turnstile.
Также поддерживаются пути:
https://api.capmonster.cloud/reportIncorrectRecaptcha, https://api.capmonster.cloud/reportIncorrectHcaptcha - работают аналогично reportIncorrectTokenCaptcha


Формат запроса: JSON POST

Параметры запроса

Параметр

Тип

Обязательный

Значение

Параметр

Тип

Обязательный

Значение

clientKey

String

Да

Уникальный ключ вашей учетной записи

taskId

Integer

Да

Идентификатор задания

Пример запроса:

{ "clientKey":"67b6bcbb1a728ea8d563de6d169a2057", "taskId": 7654321 }

 

Структура ответа:

Свойство

Тип

Значение

Свойство

Тип

Значение

errorId

Integer

Идентификатор ошибки.
0 - ошибок нет, свойство errorCode отсутствует
1 - ошибка, информация о ней находится в свойстве errorCode

errorCode

String

Код ошибки. См. глоссарий ошибок.

status

String

success - жалоба принята.
Если жалоба не принята, то поле отсутствует, причина в errorCode

Пример ответа

{ "errorId": 0, "status": "success" }
{ "errorId": 1, "errorCode": "ERROR_KEY_DOES_NOT_EXIST" }