reCAPTCHA Enterprise v3 API

著者：solvethree 更新日

バックエンドからreCAPTCHA v3 Enterpriseトークンを取得します。サイトを一度設定したら、ホスト名、アクション、プロキシを送信してください。トークンと、その送信時に使用するユーザーエージェントおよびクライアントヒントを返します。

APIを試す
このページの内容

リクエストを送信

最初の解決を実行する前に、ワークスペースで有効なサイトプロファイルを設定してください。siteにはホスト名を、actionにはそのページの実際のreCAPTCHAアクションを送信します。デフォルトはEnterprise v3です。標準のv3にはrecaptchaType: v3を使用してください。タスクにtype、ページの完全なURL、サイトキーは不要です。

POST https://api.solvethree.com/v1/tasksでタスクを作成します。Authorization: BearerヘッダーにワークスペースAPIキーを指定して認証してください。

タスクの本文 · 例の対象とプロキシを置き換えてください
{
  "site": "example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example-recaptcha-001"
}

トークンを送信

タスクが準備完了になったらsolution.tokenを読み取ります。返されたuserAgentとsecChUaを使用し、同じプロキシ経由でアプリケーションのCAPTCHAフィールドに送信してください。トークンが必要なリクエストの直前に解決を実行し、後で使うためにトークンをキャッシュしないでください。

ready状態のタスクは、解決結果が生成されたことを意味します。リクエストが受け入れられたかどうかは、対象サイトのレスポンスで確認してください。

待機とタイムアウト

作成時はデフォルトで最大15秒待機します。タスクIDを即座に受け取ってポーリングする場合は、?waitMs=0 を使用してください。

readyまたはfailedで停止してください。作成がタイムアウトした場合は、元のrequestIdを同じ入力で再利用してタスクを取得します。新しいIDを使うと、別の課金対象の解決が作成される可能性があります。

料金

解決1,000件あたり$2.00で、ワークスペース残高から支払われます。解決失敗分は返金されます。$5のウェルカムクレジットで開始でき、有料入金の最低額は$10です。

reCAPTCHA Enterprise v3 API · solvethree