すべてのプロダクト
Search

このプロダクト

    Captcha:V3 クライアントアーキテクチャの応答データ

    ドキュメントセンター

    Captcha:V3 クライアントアーキテクチャの応答データ

    最終更新日:Apr 01, 2026

    Captcha 2.0 がクライアント V3 アーキテクチャで行動検証を完了すると、検証結果と状態コードを含む応答が返されます。統合およびテスト中に返されたデータを確認するには、ブラウザの開発者ツールの [ネットワーク] タブを使用します。

    重要

    各検証コードは 1 回のみ送信可能です。初期化レコードは 20 分後に有効期限切れとなります。この間隔を超えた場合は、新しい初期化リクエストを送信してください。

    応答構造

    応答は 2 レベルで構成されています：HTTP 応答エンベロープと、HTTP 本文内にネストされた Result オブジェクトです。

    HTTP 応答パラメーター

    パラメーター型説明
    HTTP ステータスコード整数HTTP ステータスコードです。詳細については、「HTTP ステータスコード」をご参照ください。
    RequestId文字列リクエスト ID です。
    Successブール値API リクエストが成功したかどうかを示します。true：リクエストが処理されました。false：リクエストが失敗しました。
    Code文字列リターンコードです。詳細については、「HTTP ステータスコード」をご参照ください。
    Message文字列詳細メッセージです。詳細については、「HTTP ステータスコード」をご参照ください。

    Result パラメーター

    パラメーター型説明
    VerifyResultブール値検証結果です。true：検証に合格しました。false：検証に失敗しました。
    VerifyCode文字列特定の検証結果を示す検証コードです。下記の「VerifyCode の値」をご参照ください。

    VerifyCode の値

    T で始まる VerifyCode の値は検証合格を、F で始まる値は検証失敗を示します。

    パスコード

    VerifyCode説明操作
    T001クライアント側の検証が合格しました。操作を続行できます。
    T005テストモードが有効になっており、検証を合格させるように設定されています。予期しない場合は、Captcha 2.0 コンソールにログインして、ご利用のシナリオにおけるポリシーの状態を確認してください。詳細については、「統合ガイド」をご参照ください。
    T006リクエストがホワイトリストポリシーに一致し、検証を合格しました。予期しない場合は、Captcha 2.0 コンソールにログインして、ホワイトリストポリシーを確認してください。

    失敗コード

    VerifyCode説明操作
    F001攻撃の疑いあり — リクエストがリスクポリシーのチェックに不合格となりました。操作をブロックしてください。正当なトラフィックが誤ってブロックされている場合は、チケットを提出してください。
    F004テストモードが有効になっており、検証を失敗させるように設定されています。予期しない場合は、Captcha 2.0 コンソールにログインして、ご利用のシナリオにおけるポリシーの状態を確認してください。詳細については、「シナリオ管理」をご参照ください。
    F008重複送信 — このコードの検証データは既に送信済みです。各検証コードは 1 回のみ送信可能です。ユーザーに CAPTCHA を再読み込みして再度実行するよう促してください。
    F009仮想デバイス環境が検出されました（VMware、VirtualBox、Hyper-V、Parallels などの仮想マシン；AVD、BlueStacks、VBox/Hyper-V などのエミュレーター；またはモバイル端末を偽装したデスクトップブラウザ）。操作をブロックするか、Captcha 2.0 コンソールにログインして、カスタムポリシー内でこのチェックを無効化してください。詳細については、「カスタムポリシーの設定」をご参照ください。
    F010同一 IP アドレスからのアクセス頻度が制限を超えました。カスタムポリシー内でアクセス頻度のしきい値を設定するには、Captcha 2.0 コンソールにログインしてください。「カスタムポリシーの設定」をご参照ください。
    F011同一デバイスからのアクセス頻度が制限を超えました。カスタムポリシー内でアクセス頻度のしきい値を設定するには、Captcha 2.0 コンソールにログインしてください。「カスタムポリシーの設定」をご参照ください。
    F014初期化レコードが見つかりません。原因は以下の 2 つです：(1) 初期化リクエストと検証リクエストの間隔が 20 分を超え、バックエンドでレコードが削除されました。(2) 検証リクエストの前に初期化リクエストが送信されていません — これは攻撃の疑いまたは統合エラーを示している可能性があります。原因 (1) の場合は、新しい初期化リクエストを送信して再試行してください。原因 (2) の場合は、各検証リクエストの前にクライアント初期化リクエストを送信してください。
    F015検証インタラクションに失敗しました — たとえば、パズルピースが正しい位置に移動されませんでした。ユーザーに CAPTCHA を再読み込みして再度インタラクションを実行するよう促してください。
    F016コンソールで設定された URL 検証ポリシーにより、リクエストがブロックされました。カスタムポリシー内で URL 検証ポリシーを調整するには、Captcha 2.0 コンソールにログインしてください。「カスタムポリシーの設定」をご参照ください。
    F017攻撃の疑いあり — 異常なプロトコルまたはパラメーターにより、リクエストが失敗しました。操作をブロックしてください。

    HTTP ステータスコード

    HTTP ステータスコードCodeMessage
    200Success操作が正常に完了しました。
    400MissingParameter必須パラメーターが不足しています。
    401InvalidParameterパラメーターが無効です。
    403Forbidden.AccountAccessDenied権限がありません。サービスが有効化されていないか、アカウントに支払い遅延がある可能性があります。
    403Forbidden.RAMUserAccessDeniedResource Access Management (RAM) ユーザーに権限がありません。AliyunYundunAFSFullAccess 権限を付与してください。詳細については、「RAM ロールへの権限付与」をご参照ください。
    500InternalError内部システムエラーが発生しました。操作を再試行してください。エラーが継続する場合は、サポート対応のためチケットを提出してください。