操作ガイドメニュー

reportCorrectRecaptcha:正しく解決されたRecaptchaトークンレポート

このメソッドは、Recaptcha V3およびRecaptcha V2 EnterpriseタスクのreportIncorrectRecaptchaと共に使用します。 RecaptchaV2のレポートは現在受け付けられますが、最終的には無視されます。V2の品質は約99%で、成功したワーカーのホワイトリストを構築する必要はありません。

バックエンドでは、ホワイトリストにご報告のワーカーを配置し、キャプチャにワーカーを割り当てます。次回から、システムはキャプチャとこのホワイトリストを一致させます。報告されたワーカーのいずれかがオンラインでアイドル状態の場合、新しいタスクの割り当てを受け取るために最初の行から配置されます。システムはこの記録を次の1時間保持します。ホワイトリストから同じワーカーによって実行されるタスクreportIncorrectRecaptchaリクエストを送信すると、その記録を削除できます。
一言で言えば、reportCorrectRecaptchaは、ホワイトリストにワーカーを追加します。reportIncorrectRecaptchaはそれらを削除します。

正しく解決されたトークンのレポートは、毎分10タスクから始まる、顕著なボリュームで動作します。これは、異なるタスクキュー間のワーカーの移行が多く、現在のビジー状態/アイドル状態が原因です。毎分1タスクのようなボリュームでは、大きく品質を改善することはできません。

レポートは、タスクの完了後60秒内に送信する必要があります。その後でレポートを送信すると、APIはエラーERROR_NO_SUCH_CAPCHA_IDを返します。タスクごとに1つのレポートのみを送信できます。

アドレス: https://api.anti-captcha.com/reportCorrectRecaptcha
メソッド: POST
Content-type: application-json

リクエストプロパティ

プロパティ タイプ 必須 目的
clientKey 文字列 はい
taskId 整数 はい

リクエスト例

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "taskId":12345
}' https://api.anti-captcha.com/reportCorrectRecaptcha
        


レスポンス構造

プロパティ タイプ 目的
errorId 整数 エラー識別子。
0 - エラーは発生せず、操作は正常に完了しました。
>1 - エラー識別子。エラーコードと短い説明がerrorCodeおよびerrorDescriptionプロパティで転送されました。
errorCode 文字列
errorDescription 文字列 エラーの簡単な説明
status 文字列
操作の結果。エラーコードまたは苦情が受理された状態の「status="success"」が表示されます。

レスポンス例

エラーのないJSON
          {
    "errorId":0,
    "status":"success"
}
        
エラーが出たJSON
          {
    "errorId": 16,
    "errorCode": "ERROR_NO_SUCH_CAPCHA_ID",
    "errorDescription": "Task you are requesting does not exist in your current task list or has been expired."
}