report — сообщить о результате

report сообщает нам, верен ли результат группы задач. Сообщайте и об успешных, и о неудачных результатах. Если для типа распознавания изображений сообщить о неверном результате, подходящие задачи получают возврат баллов примерно через 24 часа; эти данные также используются для оценки и улучшения распознавания.

POSThttps://api.yescaptcha.com/reportГлобальный endpointКопировать

POSThttps://cn.yescaptcha.com/reportEndpoint для КитаяКопировать

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

Поле	Тип	Обязательное	Описание
id	array of string	Да	Список ID задач; можно передать сразу несколько
isSuccess	boolean	Да	true — результат верный, false — результат неверный

clientKey не нужен: задачу определяет сам ID задачи.

{
  "id": ["610ff5e0-68eb-11ef-95a6-22e70a0b794d", "65b88c06-68eb-11ef-8e9a-52540023ccb3"],
  "isSuccess": false
}

Ответ

{
  "errorId": 0,
  "status": "success"
}

Сообщайте честно

Эти данные используются и для расчёта возврата баллов, и для оценки и улучшения распознавания, поэтому сообщайте фактический результат:

• Для верных результатов передавайте isSuccess: true, для неверных — false. Сообщения, в которых отправляются только ошибки, или в которых всё помечено как ошибка независимо от результата, не учитываются в статистике и расчёте.
• Доля ошибок считается по всем задачам, созданным вами за период, а не только по тем, о которых вы сообщили. Больше сообщений об ошибках не даёт больше возврата: если ваша доля ошибок заметно выше, чем у других за тот же период, возврат считается по доле ошибок за этот период.
• Если для одной проверки использовано несколько изображений (например, FunCaptcha требует 5 раундов) и неизвестно, какое из них неверное, можно сообщить об ошибке для всей группы задач сразу; если проверка пройдена, так же сообщите об успехе для всей группы.

Возврат баллов после жалобы

• Возврат баллов возможен только для 5 типов распознавания изображений: FunCaptchaClassification, HCaptchaClassification, ReCaptchaV2Classification, AwsClassification, bCaptchaClassification.
• Учитываются только сообщения, отправленные в течение 1 часа после создания задачи; по одной задаче возврат происходит только один раз.
• Возврат происходит не сразу, а примерно через 24 часа, при общем расчёте.
• При расчёте ваша доля ошибок сравнивается с другими пользователями за тот же период по тому же вопросу; если ваша доля заметно выше уровня за период, возврат считается по доле ошибок за этот период.
• Если у вас есть вопросы по расчёту, можно подать апелляцию, обратившись в поддержку.

Для задач, возвращающих токен (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha и др.), принятие токена определяет целевой сайт, поэтому возврат баллов за такие сообщения не производится. Сводка правил тарификации: Тарификация и возврат баллов.