すべてのプロダクト
Search

このプロダクト

    ID Verification:CheckResult

    ドキュメントセンター

    ID Verification:CheckResult

    最終更新日:Dec 25, 2025

    このトピックでは、CheckResult API 操作を使用して認証結果をクエリする方法について説明します。

    API の説明

    • 操作名: CheckResult

    • リクエストメソッド: HTTPS POST

    • 説明: コールバック通知を受信した後、サーバーでこの操作を呼び出して、認証ステータスと資料を取得できます。

      重要

      デフォルトでは、ID Verification サービスの結果は 30 日間保存されます。この期間が過ぎると、システムは自動的にそれらを削除します。認証完了後 30 日以内に認証結果をクエリする必要があります。

    • QPS 制限: この API は、排他的な秒間クエリ数 (QPS) 制限の対象となります。詳細については、「ID Verification サーバーサイド API の QPS 制限」をご参照ください。

    • エンドポイント:

      説明

      内部ネットワークは、同じリージョン内の Alibaba Cloud プロダクト間のプライベート通信ネットワークです。アプリケーションサーバーが Alibaba Cloud リージョンにデプロイされている場合、内部エンドポイントを使用して ID Verification サービスにアクセスできます。これにより、より安全で安定したネットワーク接続が提供されます。

      中国 (香港)

      • パブリックエンドポイント: cloudauth-intl.cn-hongkong.aliyuncs.com

      • 同一リージョン内の内部エンドポイント: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    オンラインでのデバッグと統合

    説明

    デバッグと統合を行う前に、「OpenAPI Explorer を使用してサーバーサイド API 操作をデバッグおよび統合する」ドキュメントをお読みください。OpenAPI プラットフォームで API 操作を呼び出す方法と、SDK とそのサンプルコードを取得する方法について説明しています。

    OpenAPI Explorer を使用して、この API 操作を直接呼び出してデバッグし、 SDK コード例を生成できます。

    リクエストパラメーター

    名前

    タイプ

    必須

    説明

    例

    MerchantBizId

    String

    はい

    カスタマイズする一意のビジネス ID。問題の追跡とトラブルシューティングに使用されます。ID は最大 32 文字の英数字の組み合わせにすることができます。ID が一意であることを確認してください。

    説明

    Alibaba Cloud サーバーはこの ID の一意性をチェックしません。追跡を改善するために、ID が一意であることを確認することを強くお勧めします。

    e0c34a77f5ac40a5aa5e6ed20c35****

    TransactionId

    String

    はい

    認証プロセス全体の一意の識別子。Initialize API 操作を呼び出してこの値を取得します。

    重要

    改ざんの脅威を防ぐために、この値は Initialize API 操作の呼び出しからサーバーに保存されている TransactionId である必要があります。クライアント側のコールバックからの TransactionId を使用することはお勧めしません。

    hksb7ba1b28130d24e015d6********

    IsReturnImage

    String

    いいえ

    認証イメージ資料を返すかどうかを指定します。

    • Y: 必須

    • N: いいえ (デフォルト)

    Y

    レスポンスパラメーター

    名前

    タイプ

    説明

    例

    HTTP ステータスコード

    Integer

    HTTP ステータスコード。

    200

    HTTP 本文

    RequestId

    String

    リクエスト ID。

    130A2C10-B9EE-4D84-88E3-5384FF03****

    Code

    String

    レスポンスコード。

    Success

    Message

    String

    レスポンスコードの詳細な説明。

    success

    Result.Passed

    String

    最終的な認証結果。有効な値:

    • Y: 成功

    • N: 失敗

    Y

    Result.SubCode

    String

    認証結果の説明。詳細については、「ResultObject.SubCode エラーコード」をご参照ください。

    200

    Result.ExtFaceInfo

    String

    顔のライブネス検証の結果に関する情報。JSON フォーマットについては、右側の例をご参照ください。詳細については、「ExtFaceInfo」をご参照ください。

    {
  "faceAttack": "N",
  "faceComparisonScore": 99.99,
  "faceImg": "Base64 format",
  "facePassed": "Y",
  "faceQuality": 95.45,
  "faceOcclusion": "N",
  "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm"
}

    ExtFaceInfo

    名前

    タイプ

    説明

    例

    facePassed

    String

    顔のライブネス検証の最終結果。

    • Y: 成功

    • N: 失敗

    Y

    faceComparisonScore

    Double

    キャプチャされた顔と証明書の顔との顔照合の類似度スコア。値の範囲は 0 から 100 です。

    説明

    スコアが高いほど、顔が同一人物のものである確率が高くなります。デフォルトのしきい値は 90 です。ビジネスデータに基づいてしきい値をカスタマイズすることもできます。

    99.99

    faceImg

    String

    キャプチャされた顔イメージ (Base64 フォーマット)。リクエストで IsReturnImage を Y に設定し、顔スキャンが完了した場合にこのフィールドが返されます。

    Base64 フォーマット

    faceAttack

    String

    キャプチャされた顔でライブネス攻撃が検出されたかどうかを示します。

    • Y: 攻撃が検出されました。

    • N: 該当なし

    N

    faceQuality

    Double

    顔のライブネス検証用の顔イメージの品質スコア。値の範囲は 0 から 100 です。

    99.99

    faceOcclusion

    String

    顔がオクルージョンされているかどうかを示します。

    • Y: 顔はオクルージョンされています。

    • N: 顔はオクルージョンされていません。

    N

    docVideoUrl

    String

    証拠ビデオの OSS ダウンロード URL。

    説明

    • 証拠ビデオの URL は 15 分間有効です。

    • 認証完了後 30 分以内であれば、ビデオを繰り返しクエリして取得できます。30 分後、システムは証拠ビデオファイルを自動的に削除します。ファイルは回復できません。ファイルを速やかにダウンロードして保存してください。

    https://aliyun-cloudauth.oss-aliyuncs.com/******.webm

    faceAge

    String

    顔イメージに基づいて予測された参照年齢。予測に失敗した場合、このフィールドは返されないことがあります。

    30

    faceGender

    String

    顔イメージに基づいて予測された性別。予測に失敗した場合、このフィールドは返されないことがあります。

    • M: 男性

    • F: 女性

    M

    faceAttackScore

    Double

    顔認識アルゴリズムによって予測されたなりすまし攻撃の確率。スコアが高いほど、なりすまし攻撃の確率が高くなります。

    値の範囲は 0 から 100 です。

    80

    guardRiskScore

    Double

    Face-Guard アルゴリズムによって予測されたデバイスリスクの確率。スコアが高いほど、デバイスリスクが高くなります。

    値の範囲は 0 から 100 です。

    90

    リターンコード

    HTTP ステータスコード

    コード

    メッセージ

    200

    Success

    リクエストは成功しました。

    400

    MissingParameter

    パラメーターを空にすることはできません。

    InvalidParameter

    無効なパラメーターです。

    TransactionIdInvalid

    無効なトランザクション ID です。

    403

    Forbidden.RAMUserAccessDenied

    RAM ユーザーに AliyunAntCloudAuthFullAccess 権限を付与する必要があります。詳細については、「RAM ユーザーにサービスへのアクセスを承認する」をご参照ください。

    Forbidden.AccountAccessDenied

    ID Verification を有効にし、アカウントに支払い遅延がないことを確認してください。

    Throttling.Api

    スロットリングのため API リクエストがブロックされました。

    404

    ProcessNotCompleted

    認証プロセス全体が完了していません。

    500

    InternalError

    内部システムエラー。トラブルシューティングのためにエンジニアにフィードバックを提供してください。

    ResultObject.SubCode エラーコード

    エラーコード

    認証レコードは課金されますか

    説明と推奨される理由

    200

    はい

    認証に成功しました。

    204

    はい

    顔照合が一致しません。別人であるか、ライブネス写真の品質が低い可能性があります。

    205

    はい

    ライブネス検出でリスクが示されました。

    206

    はい

    ビジネスポリシーの制限。

    説明

    セーフモードが有効になっている場合、認証デバイスと環境でセキュリティチェックが実行されます。リスクが検出された場合、認証結果は失敗します。ユーザーに、デバイス上の複数インスタンス、クローン、仮想環境ソフトウェアまたはプラグインをアンインストールし、デバイスを初期の安全な状態に復元して再試行するように促すことができます。