reCAPTCHA v2 EnterprisesolverAPI
APIの稼働状況
- 24時間の稼働状況
- 正常
- 24時間の平均応答時間
- —
- 良好／正常
- 利用可能
- 制限あり
- ほぼ停止
過去24時間
過去30日間
EverySolveのreCAPTCHA v2 Enterprise APIは、チャレンジ処理に使用するトークンを返します。typeをrecaptcha_v2_enterpriseに設定し、以下の入力項目を指定してPOST /api/v1/captchaに送信してください。reCAPTCHA v2 Enterpriseは、enterprise.jsとgrecaptcha.enterpriseを通じて読み込まれる、チェックボックス型またはポリシー駆動型のEnterpriseキーです。 返す値は同じくgRecaptchaResponseですが、Enterpriseの識別子やペイロードを、従来のv2のapi.jsの値やスコアベースのv3キーと混在させないでください。
1,000回の解決成功あたり$1.53（解決成功1回につき$0.001528）。解決に失敗した場合は課金されません。
AIプロンプト
EveryInfraの「reCAPTCHA v2 Enterprise」APIを呼び出すスクリプトの作成を手伝ってください。
APIの仕様：
- リクエスト：POST https://api.everyinfra.com/api/v1/captcha、ヘッダーはAuthorization: Bearer <API Key>。キーは環境変数EVERYINFRA_API_KEYから読み込み、コードには直接書かないでください。
- リクエストボディでは、typeをrecaptcha_v2_enterpriseに設定し、パラメータを同じ階層に並べてください。
- 必須パラメータ：
- website_url: このチャレンジが表示されるページを正確に指定します。サイトのトップページだけでなく、該当するパスも含めてください。
- website_key: 対象の実装からそのままコピーした公開サイトキーまたはウィジェットキーです。シークレットキーではありません。
- 任意パラメータ：
- enterprise_payload: 対象のreCAPTCHA実装が提供する、Enterprise固有のページデータです（存在する場合）。
- page_action: 対象のreCAPTCHA実行時に使用されるアクション文字列です。大文字・小文字と綴りは正確にそのまま指定してください。
- invisible: 対象のウィジェットが非表示（invisible）モードを使うかどうかです。画像がないことだけを根拠に判断しないでください。
- api_domain: 対象のウィジェットが標準ドメインとは異なるホストを使用する場合のAPIホスト名です。（指定可能な値：www.google.com / www.recaptcha.net）
- リクエストボディの例：
{
"type": "recaptcha_v2_enterprise",
"website_url": "<website_url>",
"website_key": "<website_key>"
}
- 課金：1,000回の解決成功あたり$1.53（解決成功1回につき$0.001528）。解決に失敗した場合は課金されません。
- 422の場合は、エラーに含まれる提案と指定可能な値をもとにパラメータを修正してください。429または503の場合は、Retry-Afterで指定された時間だけ待ってから再試行してください。
コードを書く前に、処理する件数と結果の保存形式を私に確認し、そのうえで、計画と概算費用について私の了承を得てください。リクエストパラメータ
| 名前 | 場所 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|---|
Authorization | header | string | はい | - | Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。 |
type | body | string | はい | recaptcha_v2_enterprise | CAPTCHAの種類です（固定値）。 |
website_url | body | string | はい | - | このチャレンジが表示されるページを正確に指定します。サイトのトップページだけでなく、該当するパスも含めてください。 |
website_key | body | string | はい | - | 対象の実装からそのままコピーした公開サイトキーまたはウィジェットキーです。シークレットキーではありません。 |
enterprise_payload | body | object | いいえ | - | 対象のreCAPTCHA実装が提供する、Enterprise固有のページデータです（存在する場合）。 |
page_action | body | string | いいえ | - | 対象のreCAPTCHA実行時に使用されるアクション文字列です。大文字・小文字と綴りは正確にそのまま指定してください。 |
invisible | body | boolean | いいえ | - | 対象のウィジェットが非表示（invisible）モードを使うかどうかです。画像がないことだけを根拠に判断しないでください。 |
api_domain | body | string (enum) | いいえ | - | 対象のウィジェットが標準ドメインとは異なるホストを使用する場合のAPIホスト名です。指定可能な値www.google.comwww.recaptcha.net |
コードサンプル
curl -X POST 'https://api.everyinfra.com/api/v1/captcha' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"type": "recaptcha_v2_enterprise",
"website_url": "<website_url>",
"website_key": "<website_key>"
}'OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
このパラメータのサンプルレスポンスはまだありません。このプレビューはAPI定義に基づくレスポンスの構造とフィールドを示したもので、値は…で表しています。実際の呼び出し結果ではありません。
{
"id": "req_…",
"type": "recaptcha_v2_enterprise",
"solution": {
"gRecaptchaResponse": "…"
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}reCAPTCHA v2 Enterpriseのパラメータの取得元
Enterpriseキーはdata-sitekeyまたはgrecaptcha.enterprise.renderからコピーします。page_actionとenterprise_payloadは、対象の実装が提供している場合にのみ、そのまま保持してください。
ページ上でこれらの値を見つけるコード
grecaptcha.enterprise.render('html_element', { 'sitekey': '<sitekey>', 'action': 'LOGIN', 'theme': 'light', 'callback': verifyCallback });
reCAPTCHA v2 Enterpriseの見分け方
reCAPTCHA v2 Enterpriseは、enterprise.jsとgrecaptcha.enterpriseを通じて読み込まれる、チェックボックス型またはポリシー駆動型のEnterpriseキーです。
reCAPTCHA v2 Enterpriseの特徴
返す値は同じくgRecaptchaResponseですが、Enterpriseの識別子やペイロードを、従来のv2のapi.jsの値やスコアベースのv3キーと混在させないでください。
reCAPTCHA v2 Enterprise APIの使い方
reCAPTCHA v2 Enterprise APIはgRecaptchaResponseでトークンを返します。ソリューションの形式はtokenです。 対象のワークフローが想定するフィールドまたは検証リクエストで、トークンを送信します。
- 01GET /api/v1/captcha/typesを取得し、
recaptcha_v2_enterpriseのエントリを選択します。 - 02
type: "recaptcha_v2_enterprise"と必須パラメータをPOST /api/v1/captchaに送信します。 - 03
gRecaptchaResponseからトークンを読み取ります。 - 04対象のワークフローが想定するフィールドまたは検証リクエストで、トークンを送信します。
課金と提供状況 EverySolveはソリューションを正常に返した場合のみ課金します。失敗した試行では最終的な課金は発生せず、仮押さえされた金額は自動的に戻ります。availableと価格フィールドはページ上の固定情報とみなさず、リクエスト時にGET /api/v1/captcha/typesから取得してください。
reCAPTCHA v2 Enterpriseの連携に関するよくある質問
タイプを選ぶ前に、reCAPTCHA v2 Enterpriseかどうかを見分けるにはどうすればよいですか？
reCAPTCHA v2 Enterpriseは、enterprise.jsとgrecaptcha.enterpriseを通じて読み込まれる、チェックボックス型またはポリシー駆動型のEnterpriseキーです。 recaptcha_v2_enterpriseは、これらのシグナルが対象のチャレンジと一致することを確認してから使用してください。
reCAPTCHA v2 Enterpriseリクエストには、対象ページのどの値を含めればよいですか？
Enterpriseキーはdata-sitekeyまたはgrecaptcha.enterprise.renderからコピーします。page_actionとenterprise_payloadは、対象の実装が提供している場合にのみ、そのまま保持してください。 website_urlとwebsite_keyを指定してください。 任意パラメータはenterprise_payload、page_action、invisible、api_domainです。
reCAPTCHA v2 Enterpriseは何を返しますか？また、混同してはいけないものは何ですか？
reCAPTCHA v2 Enterprise APIはgRecaptchaResponseでトークンを返します。ソリューションの形式はtokenです。 返す値は同じくgRecaptchaResponseですが、Enterpriseの識別子やペイロードを、従来のv2のapi.jsの値やスコアベースのv3キーと混在させないでください。
reCAPTCHA v2 Enterpriseの連携について説明している外部資料はどれですか？
Google Cloudは、Enterpriseのチェックボックスキー、data-sitekey、data-action、grecaptcha.enterprise.renderについてドキュメントを公開しています。[reCAPTCHA v2 Enterpriseのリファレンスを開く](https://docs.cloud.google.com/recaptcha/docs/instrument-web-pages-with-checkbox)。EverySolve固有のフィールドとリアルタイムの提供状況は、引き続きタイプカタログで確認してください。
reCAPTCHA v2 Enterpriseのリファレンス
関連するCAPTCHAタイプ
エラーと課金
- 401
- キーが未指定か無効です。
- 402
- 残高が不足しています。先にチャージしてください。
- 422
- パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
- 429
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200（空）
- データがありません。課金はされません。