# report 結果の報告

> POST /report でタスクの認識結果が正しかったかを報告します。成功も失敗も正直に報告してください。画像認識タイプはタスク作成後 1 時間以内に失敗を報告すると、約 24 時間後に返金が精算されます。

Source: https://docs.yescaptcha.com/ja/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` (グローバルエンドポイント)
- POST `https://cn.yescaptcha.com/report` (中国エンドポイント)

## リクエストパラメータ

| フィールド | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `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` で報告します。失敗だけを報告する、または正誤にかかわらずすべて失敗として報告する場合、その報告は統計や精算の参考にされません。
-   失敗率は、その期間に作成したすべてのタスクをもとに計算され、報告したタスクだけが対象ではありません。失敗を多く報告しても返金は増えません。失敗率が同期間の水準より明らかに高い場合は、同期間の失敗率で返金されます。
-   1 回の認証で複数の画像を使い（例：FunCaptcha は 1 回で 5 ラウンドを選択）、どれが誤りだったか分からない場合は、そのグループのタスクをまとめて失敗として報告できます。認証が通ったときも、同様にそのグループをまとめて成功として報告します。

## 失敗報告による返金

-   返金の対象になるのは、次の 5 種類の画像認識タイプのみです：`FunCaptchaClassification`、`HCaptchaClassification`、`ReCaptchaV2Classification`、`AwsClassification`、`bCaptchaClassification`。
-   タスク作成後 **1 時間以内**の報告のみが対象で、同じタスクが返金されるのは 1 回だけです。
-   即時ではなく、**約 24 時間後**にまとめて精算されます。
-   精算時には、同じ期間・同じ問題文の他のユーザーと比較します。報告された失敗率が同期間の水準より明らかに高い場合は、同期間の失敗率で返金されます。
-   精算に疑問がある場合は、[サポートに問い合わせ](https://docs.yescaptcha.com/ja/help/contact.md)て申し立てできます。

token を返すタイプ（reCAPTCHA、hCaptcha、Turnstile、FunCaptcha など）は、token が通るかどうかを対象サイトが判定するため、報告しても返金されません。課金ルールのまとめは [課金と返金](https://docs.yescaptcha.com/ja/getting-started/billing.md) を参照してください。
