操作ガイドメニュー

RecaptchaV3TaskProxyless: Google Recaptcha v3の解決

このタイプのタスクオブジェクトは、ワーカーのコンピュータでGoogle RecaptchaV3を解決するために必要です。 このタスクは、独自のプロキシサーバまたはワーカーのIPアドレス(あるいはその両方)を使用して当社のサービスによって実行されます。

RecapchaV2-invisibleとRecapchaV3には違いがあることにご注意ください。両者は同じように見えるので、混乱させるかもしれません。正しいタイプを簡単に判別する方法があります。V2-invisibleとV3でAPIを使用して解決してみてください。どちらかの試みでエラーが発生する場合、もう一方ではエラーが発生しません。

ワーカーのrecapcha"score"をテストし、次の3つのグループ(キュー)に分類します。0.30.7、および0.9。それぞれの価格は、アイドル状態のワーカー数によって若干異なる場合があります。プロパティminScoreを渡すことで、タスクが入力するキューを定義します。利用可能なワーカーのほとんどはスコアが0.3で、最低金額は0.9です

RecapchaV3に関する詳細は、これFAQセクションをご参照ください。

Recapchav3の例。通常、ページの右下にロゴバッジがあります。しかし、Javascriptでは簡単に削除できます。

タスクオブジェクト

プロパティ タイプ 必須 目的
type 文字列 はい RecaptchaV3TaskProxyless
websiteURL 文字列 はい ターゲットページのアドレス。ユーザーエリアでも、ウェブサイトのどこにでも挿入できます。ワーカーは実際にアクセスしませんが、代わりに訪問をシミュレートします。
websiteKey 文字列 はい ReCAPTCHAサイトキー。この記事でご確認ください。
minScore ダブル はい 必要なスコアでワーカーをフィルタリングします。値は次のいずれかになります。
0.3
0.7
0.9
pageAction 文字列 いいえ
Recapchaの"action"値。ウェブサイトの所有者は、このパラメータを使用して、ユーザがページで何をしているかを定義します。
例:

grecaptcha.execute('site_key', {action:'login_test'})
isEnterprise ブール型 いいえ エンタープライズAPIを使用してこのV3を解決する必要がある場合は、このフラグを"true"に設定します。 デフォルト値は"false"であり、Recaptchaは非企業APIで解決されます。次の例のように、javascriptコールによって判別できます。

grecaptcha.enterprise.execute('site_key', {..})

リクエスト例

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "task":
        {
            "type":"RecaptchaV3TaskProxyless",
            "websiteURL":"http://mywebsite.com/recaptcha/test.php",
            "websiteKey":"6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16",
            "minScore": 0.3,
            "pageAction": "myverify",
            "isEnterprise": false
        }
}' https://api.anti-captcha.com/createTask
        

レスポンス例

エラーのないJSON
          {
    "errorId": 0,
    "taskId": 7654321
}
        
エラーが出たJSON
          {
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}
        

ソリューションの取得

ソリューションをリクエストするには、getTaskResultメソッドを使用します。最初のリクエストを送信する前に、ワーカーに5秒ほど時間を与えます。ワーカーが忙しい場合は、3秒以内に再試行します。

タスクソリューションオブジェクト

プロパティ タイプ 目的
gRecaptchaResponse 文字列 ターゲットウェブサイトで送信フォームでやり取りするために必要なトークン文字列。

レスポンス例

エラーのないJSON
          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}