GitHub
操作ガイドメニュー
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."
}