すべてのプロダクト
Search

このプロダクト

    ID Verification:CheckResult

    ドキュメントセンター

    ID Verification:CheckResult

    最終更新日:Jan 27, 2025

    このトピックでは、CheckResult 操作を呼び出して検証結果を照会する方法について説明します。

    使用上の注意

    操作名: CheckResult。

    エンドポイント: cloudauth-intl.cn-hongkong.aliyuncs.com。

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

    操作の説明: コールバック通知を受信した後、この操作を呼び出して、ID Verification - KYC から検証リクエストのステータスと結果を取得できます。 KYC は Know Your Customer の略です。

    QPS 制限: API のクエリ/秒 (QPS) には制限が課せられています。 詳細については、「ID Verification - KYC サーバー側 API の QPS 制限」をご参照ください。

    リクエストパラメーター

    パラメーター

    タイプ

    必須

    説明

    例

    MerchantBizId

    String

    はい

    ビジネスのカスタム一意識別子。トラブルシューティングに使用されます。 32 文字以内で文字と数字を含むカスタム値を指定できます。 値が一意であることを確認してください。

    説明

    ID Verification は値の一意性をチェックしません。 追跡のために、一意の値を指定することをお勧めします。

    e0c34a77f5ac40a5aa5e6ed20c35****

    TransactionId

    String

    はい

    検証プロセスの一意識別子。 Initialize 操作を呼び出して値を取得できます。

    hksb7ba1b28130d24e015d694361bee4

    IsReturnImage

    String

    いいえ

    検証に使用される画像を返すかどうかを指定します。 有効な値:

    • Y

    • N (デフォルト)

    Y

    レスポンスパラメーター

    パラメーター

    タイプ

    説明

    例

    HTTP ステータスコード

    Integer

    HTTP ステータスコード。

    200

    HTTP 本文

    RequestId

    String

    リクエスト ID。

    130A2C10-B9EE-4D84-88E3-5384FF039795

    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 形式,

    "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。

    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

    Object Storage Service (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

    顔ガードアルゴリズムによって予測されたデバイスリスクの確率。 値が大きいほど、デバイスリスクの確率が高いことを示します。

    有効な値: 0 ～ 100。

    90

    コードとメッセージの説明

    HTTP ステータスコード

    コード

    メッセージ の説明

    200

    Success

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

    400

    MissingParameter

    必須パラメーターが空です。

    400

    InvalidParameter

    パラメーターが無効な値に設定されています。

    400

    TransactionIdInvalid

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

    403

    Forbidden.RAMUserAccessDenied

    AliyunAntCloudAuthFullAccess ポリシーが Resource Access Management (RAM) ユーザーにアタッチされていません。 詳細については、「RAM ユーザーに ID Verification - KYC へのアクセスを承認する」をご参照ください。

    403

    Forbidden.AccountAccessDenied

    アカウントの支払いが遅延しています。 アカウントへの入金を行い、もう一度お試しください。

    403

    Throttling.Api

    API の速度制限がトリガーされました。

    404

    ProcessNotCompleted

    検証プロセスが完了していません。

    500

    InternalError

    内部エラーが発生しました。 エラーをトラブルシューティングするには、エンジニアにフィードバックを送信することをお勧めします。

    ResultObject.SubCode のコード

    コード

    課金対象

    説明と原因

    200

    はい

    顧客は検証に合格しました。

    204

    はい

    ドキュメントの顔とライブの顔が一致しません。 考えられる原因は、顔が異なる人物のものであるか、ライブの顔の品質が悪いことです。

    205

    はい

    生体検知の結果にリスクが示されています。

    206

    はい

    ポリシーの制限によりエラーが発生しました。 セキュリティモードが有効になっている場合、検証デバイスなどの環境情報に対してセキュリティチェックが実行されます。 リスクの可能性が検出された場合、検証は失敗します。 顧客に、マルチボクシング、マルチユーザー、仮想環境用のソフトウェアやプラグインなどのソフトウェアまたはプラグインをデバイスからアンインストールし、デバイスシステムのセキュリティ環境を初期状態に復元して、再試行するように通知できます。