Как жаловаться на плохие токены
Зачем жаловаться?
Жалобы нужны, чтобы мы автоматически анализировали данные о качестве токенов выдаваемых нашим API. Жалобы автоматически обрабатываются, и командой принимаются действия по улучшению качества токенов, будь то доработка системы под новые задания, улучшение сеток и тд.
Адреса методов
Для жалоб на капчи-картинки
Для жалоб на токен-капчи: recaptcha(2,3, enterprise), hcaptcha, geetest, funcaptcha, turnstile.
https://api.capmonster.cloud/reportIncorrectTokenCaptcha
Также поддерживаются пути:
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"
}