CAPTCHA 初期化 API は、ご利用のユーザータグ (プレフィックス) を含むリクエストを使用して CAPTCHA リソースをフェッチします。リクエストは xxxxx.captcha-open.aliyuncs.com に送信されます。ここで、xxxxx はご利用のユーザータグです。ユーザータグを取得するには、「Captcha サービスのアクティブ化」をご参照ください。
初期化応答が成功すると、次のようになります。
API エラーコード
初期化に失敗すると、API は次のいずれかのエラーコードを返します。
| エラーコード | タイプ | 説明と修正 |
|---|---|---|
IllegalUserTag | 設定 | ユーザータグ (プレフィックス) パラメーターが無効です。「Captcha サービスのアクティブ化」をご参照いただき、値が正しく渡されていることを確認してください。 重要 このエラーは、Web および H5 クライアント統合とアプリクライアント統合にのみ適用され、WeChat ミニプログラム統合には適用されません。 |
IllegalCertifyId | 設定 | certifyId (UserCertifyId) のフォーマットが無効です。必須フォーマットは [ユーザータグ (プレフィックス)]_[大文字、小文字、数字からなる10桁の文字列] です。コードサンプルについては、「UserCertifyId パラメーターのコードサンプル」をご参照ください。 |
IllegalScene | 設定 | ユーザー タグ (プレフィックス)シーン ID (SceneId) パラメーターが無効です。SceneId の値が正しいこと、およびシーンがユーザータグ (プレフィックス) に関連付けられたアカウントで作成されていることを確認してください。 |
Forbidden.AccountAccessDenied | アカウント | アカウントに支払い遅延があります。アカウントステータスが正常であることを確認してください。 |
Throttling | レート制限 | 秒間クエリ数 (QPS) がプロダクト制限を超えています。より高い QPS が必要な場合は、事前にアカウントマネージャーにご連絡いただき、ご確認ください。 |
ThrottlingByStrategy | レート制限 | 初期化リクエストのレート制限がトリガーされました。これは、高頻度でリクエストを送信することで CAPTCHA 質問ライブラリを走査する試みをブロックするセキュリティメカニズムです。 |
パラメーター検証エラー
パラメーター値が無効な場合、初期化はフィールドレベルのエラーで失敗します。次の表に、影響を受ける各フィールドと修正方法を示します。
| フィールド | 説明と修正 |
|---|---|
| 一般的な型検証 | パラメーターの型が無効です。「パラメーターの説明」をご参照いただき、正しい型の値を渡してください。 |
language | language パラメーター値が無効です。有効な値については、「Captcha 2.0 でサポートされている言語」をご参照ください。 |
region | region パラメーター値が無効です。要件については、「region パラメーターの説明」をご参照ください。 |
mode | mode パラメーター値が無効です。サポートされている値は popup と embed です。詳細については、「mode パラメーターの説明」をご参照ください。 |
element/button | element または button 要素がページに存在しないか、パラメーター値がページ上の要素の ID セレクターと一致しません。要素が存在し、パラメーターがその ID セレクターと一致することを確認してください。 |
フィールド | エラーメッセージ |
一般的な型検証 | 入力パラメーターのデータの型が無効です。正しいデータの型については、「パラメーターの説明」をご参照ください。 |
language |
|
region | 「 |
mode |
|
element/button |
|