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

Подавать жалобу на некорректные токены, предоставленные CapMonster Cloud, следует в тех случаях, когда они не приводят к успешному прохождению проверки на сайте или часто отклоняются.

Примеры ситуаций, когда следует подавать жалобу:

• Пользователь получил токен для решения, но сайт по-прежнему не пропускает его как правильное решение капчи.

• На некоторых сайтах токены успешно принимаются, а на других - отклоняются.

• Отклонение на сайтах, которые ранее успешно принимали подобные токены.

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

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

---

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

Для жалоб на капчи-картинки

https://api.capmonster.cloud/reportIncorrectImageCaptcha

Для жалоб на токен-капчи: recaptcha(2,3, enterprise), geetest, turnstile.

https://api.capmonster.cloud/reportIncorrectTokenCaptcha

Также поддерживается путь:

https://api.capmonster.cloud/reportIncorrectRecaptcha работает аналогично https://api.capmonster.cloud/reportIncorrectTokenCaptcha

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

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

Параметр	Тип	Обязательный	Значение
clientKey	String	Да	Уникальный ключ вашей учетной записи
taskId	Integer	Да	Идентификатор задания

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

{

  "clientKey":"API_KEY",
  "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"
}