Skip to main content
この記事では、ユーザーが Recaptcha2 認証画像を認識してクリックすることなく、Website Key を提出するだけでバックエンドで自動的にデコードを実現し、認証を完了できる Recaptcha2 プロトコル認識 API の接続説明を紹介します。

​
申請プロセス

API を使用するには、まず Recaptcha2 プロトコル認識 API の該当ページでサービスを申請する必要があります。ページに入ったら、「Acquire」ボタンをクリックします。以下の図のように： まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。 初回申請時には無料のクレジットが付与され、この API を無料で使用できます。

​
基本的な使用法

まず、基本的な使用方法を理解します。処理する必要のある認証コードのウェブサイトの URL を入力するだけで、処理された結果を得ることができます。最初に website_url フィールドを簡単に渡す必要があります。私たちのサンプルサイトは：https://www.google.com/recaptcha/api2/demo です。この website_url ページで website_key を取得する必要があります。まず、このウェブページを開き、F12 を押してコンソールに入り、最後に Element ページでグローバル検索を行い recaptcha-demo を探します。以下の結果が得られます：

ここでの data-sitekey に対応する一連の文字列が website_key の値です。以下は具体的なパラメータ結果です：

ここでは、Request Headers を設定しています。これには以下が含まれます：
  • accept：受け取りたいレスポンス結果の形式。ここでは application/json、つまり JSON 形式を記入します。
  • authorization：API を呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
さらに、Request Body を設定しています。これには以下が含まれます：
  • website_url：処理する必要のある認証コードのウェブサイトの URL。
  • website_key：Recaptcha2 におけるウェブサイトのキー識別子。
選択後、右側にも対応するコードが生成されていることがわかります。以下の図のように：

「Try」ボタンをクリックするとテストが行えます。上の図のように、ここで以下の結果が得られました：
結果には複数のフィールドが含まれており、以下のように説明されています：
  • token、今回のRecaptcha2の検証結果です。
Recaptcha2の検証結果を取得できたことがわかります。これをPOSTまたはターゲットサイトにシミュレートして送信するために使用できます。一度限りの使用で、有効期限は120秒です。60秒以内の使用を推奨します。次に、処理されたtokenをターゲットサイトに送信するためのPythonバージョンを提供します。 まず、サイトがどのようにPOSTリクエストを送信するかを把握する必要があります。そうすれば、生成されたtokenを渡すことができます。最初にF12コンソールを開き、手動で確認します。最後に、サイトがPOSTリクエストを送信したことがわかります。このPOSTリクエストの構造を確認する必要があります。具体的な手順は以下の通りです：
  • まず手動で検証を行います。具体的には以下の画像の通りです：

  • 次にsubmitをクリックし、コンソールのnetworkの変化を観察します。具体的には以下の画像の通りです：

  • 今回のPOSTリクエストの構造を分析し、右クリックしてそのリクエストのCURLコードをコピーします。具体的には以下の画像の通りです：

上記の図から分析すると、今回のPOSTリクエストのURLは：https://www.google.com/recaptcha/api2/demoであり、私たちはパラメータ g-recaptcha-response を送信する必要があります。その後、処理されたトークンを下記のdataに渡すだけで、トークンを使用して検証する具体的なCURLコードは以下の通りです：
トークン検証に対応するPythonコードは以下の通りです：
その後、私たちはコードを実行し、コンソールがこのような結果になったことを観察しました：

最後に、私たちはRecaptcha2の検証プロトコルを通過しました。 また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURLのコードは以下の通りです：
Pythonの接続コードは以下の通りです：

​
エラーハンドリング

APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードと情報を返します。例えば：
  • 400 token_mismatched：不正なリクエスト、パラメータが欠落または無効な可能性があります。
  • 400 api_not_implemented：不正なリクエスト、パラメータが欠落または無効な可能性があります。
  • 401 invalid_token：未認証、無効または欠落した認証トークン。
  • 429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
  • 500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​
エラー応答の例

​
結論

この文書を通じて、Recaptcha2プロトコルを使用してAPIを識別し、ユーザーがRecaptcha2の検証画像を認識したりクリックしたりすることなく、Website Keyを提出するだけでバックエンドで自動的にデコードし、検証を完了する方法を理解しました。この文書がAPIの接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。