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

> POST /report сообщает, верен ли результат задач; сообщайте честно и об успехах, и об ошибках. Для типов распознавания изображений ошибки нужно сообщить в течение 1 часа после создания задачи, возврат баллов после жалобы рассчитывается примерно через 24 часа.

Source: https://docs.yescaptcha.com/ru/api/report/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/api/report/

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

- POST `https://api.yescaptcha.com/report` (Глобальный endpoint)
- POST `https://cn.yescaptcha.com/report` (Endpoint для Китая)

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

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

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

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

## Ответ

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

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

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

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

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

-   Возврат баллов возможен только для 5 типов распознавания изображений: `FunCaptchaClassification`, `HCaptchaClassification`, `ReCaptchaV2Classification`, `AwsClassification`, `bCaptchaClassification`.
-   Учитываются только сообщения, отправленные в течение **1 часа** после создания задачи; по одной задаче возврат происходит только один раз.
-   Возврат происходит не сразу, а **примерно через 24 часа**, при общем расчёте.
-   При расчёте ваша доля ошибок сравнивается с другими пользователями за тот же период по тому же вопросу; если ваша доля заметно выше уровня за период, возврат считается по доле ошибок за этот период.
-   Если у вас есть вопросы по расчёту, можно подать апелляцию, [обратившись в поддержку](https://docs.yescaptcha.com/ru/help/contact.md).

Для задач, возвращающих токен (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha и др.), принятие токена определяет целевой сайт, поэтому возврат баллов за такие сообщения не производится. Сводка правил тарификации: [Тарификация и возврат баллов](https://docs.yescaptcha.com/ru/getting-started/billing.md).