reportCorrectRecaptcha:正しく解決されたRecaptchaトークンレポート
このメソッドは、Recaptcha V3およびRecaptcha V2 EnterpriseタスクのreportIncorrectRecaptchaと共に使用します。 RecaptchaV2のレポートは現在受け付けられますが、最終的には無視されます。V2の品質は約99%で、成功したワーカーのホワイトリストを構築する必要はありません。
バックエンドでは、ホワイトリストにご報告のワーカーを配置し、キャプチャにワーカーを割り当てます。次回から、システムはキャプチャとこのホワイトリストを一致させます。報告されたワーカーのいずれかがオンラインでアイドル状態の場合、新しいタスクの割り当てを受け取るために最初の行から配置されます。システムはこの記録を次の1時間保持します。ホワイトリストから同じワーカーによって実行されるタスクreportIncorrectRecaptchaリクエストを送信すると、その記録を削除できます。
要するに、reportCorrectRecaptcha はワーカーをホワイトリストに追加し、reportIncorrectRecaptcha はワーカーをホワイトリストから削除します。
正しく解決されたトークンのレポーティングは、毎分10タスクから始まる顕著なボリュームで動作します。これは、異なるタスクキュー間でワーカーが大量に移動し、現在のビジー/アイドル状態が変化するためです。1分あたり1タスクのようなボリュームでは、品質の向上は感じられません。
レポートは、タスクの完了後60秒内に送信する必要があります。その後でレポートを送信すると、APIはエラーERROR_NO_SUCH_CAPCHA_IDを返します。タスクごとに1つのレポートのみを送信できます。
アドレス: https://api.anti-captcha.com/reportCorrectRecaptcha
メソッド: POST
Content-type: application-json
リクエストプロパティ
プロパティ | タイプ | 必須 | 目的 |
---|---|---|---|
clientKey | 文字列 | はい | |
taskId | 整数 | はい |
リクエスト例
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 - エラーはなく、操作は正常に完了しました。 >0 - エラー識別子。エラーコードとその短い説明は errorCode と errorDescription プロパティで利用できます。 |
errorCode | 文字列 | |
errorDescription | 文字列 | エラーの簡単な説明 |
status | 文字列 | 操作の結果。苦情が受理されると、エラーコードかstatus="success "を受け取る。 |
レスポンス例
エラーのないJSON
エラーが出たJSON
{
"errorId":0,
"status":"success"
}