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