コンテンツにスキップ
ステータスダッシュボード

API リファレンス

report 結果の報告

このページは中国語版から機械翻訳されたもので、不正確な箇所がある可能性があります。中国語版を正としてください。

report は、タスクの認識結果が正しかったかどうかを私たちに伝えるためのものです。成功も失敗も報告してください。 画像認識タイプで「誤り」と報告すると、条件を満たすものは約 24 時間後にポイントが返金されます。報告された結果は、認識の評価と改善にも使われます。

POSThttps://api.yescaptcha.com/reportグローバルエンドポイント
POSThttps://cn.yescaptcha.com/report中国エンドポイント
フィールド 型 必須 説明
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 で報告します。失敗だけを報告する、または正誤にかかわらずすべて失敗として報告する場合、その報告は統計や精算の参考にされません。
  • 失敗率は、その期間に作成したすべてのタスクをもとに計算され、報告したタスクだけが対象ではありません。失敗を多く報告しても返金は増えません。失敗率が同期間の水準より明らかに高い場合は、同期間の失敗率で返金されます。
  • 1 回の認証で複数の画像を使い(例:FunCaptcha は 1 回で 5 ラウンドを選択)、どれが誤りだったか分からない場合は、そのグループのタスクをまとめて失敗として報告できます。認証が通ったときも、同様にそのグループをまとめて成功として報告します。
  • 返金の対象になるのは、次の 5 種類の画像認識タイプのみです:FunCaptchaClassification、HCaptchaClassification、ReCaptchaV2Classification、AwsClassification、bCaptchaClassification。
  • タスク作成後 1 時間以内の報告のみが対象で、同じタスクが返金されるのは 1 回だけです。
  • 即時ではなく、約 24 時間後にまとめて精算されます。
  • 精算時には、同じ期間・同じ問題文の他のユーザーと比較します。報告された失敗率が同期間の水準より明らかに高い場合は、同期間の失敗率で返金されます。
  • 精算に疑問がある場合は、サポートに問い合わせて申し立てできます。

token を返すタイプ(reCAPTCHA、hCaptcha、Turnstile、FunCaptcha など)は、token が通るかどうかを対象サイトが判定するため、報告しても返金されません。課金ルールのまとめは 課金と返金 を参照してください。