すべてのプロダクト
Search
ドキュメントセンター

ID Verification:CheckResult

最終更新日:Jan 15, 2026

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

API の説明

  • API 操作名: CheckResult

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

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

    重要

    デフォルトでは、ID Verification サービスの結果は 30 日間保存された後、自動的に削除されます。 30 日以内に検証結果を取得する必要があります。

  • この 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

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

説明

API 操作をデバッグおよび統合する前に、「OpenAPI Explorer を使用したサーバーサイド API 操作のデバッグと統合」で API 操作の呼び出し方法、SDK とサンプルコードの取得方法をご確認ください。

この API 操作は OpenAPI Explorer で実行してデバッグしSDK コードサンプルを生成できます。

リクエストパラメーター

名前

タイプ

必須

説明

MerchantBizId

String

はい

カスタマイズする一意のビジネス識別子。 問題の追跡とトラブルシューティングに使用します。 識別子は、文字と数字で構成される一意の 32 文字の文字列である必要があります。

説明

Alibaba Cloud サーバーはこのフィールドの一意性をチェックしません。 追跡を改善するために、このフィールドが一意であることを確認してください。

e0c34a77f5ac40a5aa5e6ed20c35****

TransactionId

String

はい

検証フロー全体の一意の識別子。 Initialize API 操作を呼び出してこの値を取得します。

重要

改ざんを防ぐため、Initialize 操作を呼び出す際には、クライアントサイドのコールバックから返された TransactionId ではなく、サーバーに保存されている TransactionId を使用してください。

hksb7ba1b28130d24e015d6********

IsReturnImage

String

いいえ

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

  • Yes: 必須

  • 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",
  "faceImg": "/9j/4AAQSkZJRgABAQAAAQqviV6oakp8...",
  "faceQuality": 95.45,
  "faceOcclusion": "N",
  "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

ExtFaceInfo

名前

タイプ

説明

facePassed

String

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

  • Y: 成功

  • N: 失敗

Y

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

authorityComparisonScore

Double

キャプチャされた顔と公式の権威あるデータソースからの顔との顔照合の類似度スコア。 値の範囲は 0 から 100 です。

説明

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

99.99

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

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

503

ServiceUnavailable

サービスは利用できません。 トラブルシューティングのためにエンジニアにお問い合わせください。

ResultObject.SubCode のエラーコード

エラーコード

認証レコードは課金対象ですか?

説明、原因、および推奨事項

200

はい

認証が成功しました。

201

はい

名前と ID カード番号が公式データベースの情報と一致しません。 ユーザー情報が正しくないか、偽物である可能性があります。 ユーザーに情報を確認して再試行するようアドバイスしてください。

説明

このエラーコードは、プロダクトによって検証される証明書のタイプが中国の ID カードであり、権威検証機能が有効になっている場合にのみ返されます。

202

はい

公式データベースで ID 情報が見つかりません。 手動レビューのエントリを予約してください。

説明

このエラーコードは、プロダクトによって検証される証明書のタイプが中国の ID カードであり、権威検証機能が有効になっている場合にのみ返されます。

205

はい

ライブネス検知にはリスクが伴います。

206

はい

ビジネスポリシーによって制限されています。 セーフモードを有効にすると、システムはデバイスなどの認証環境に対してセキュリティチェックを実行します。 潜在的な脅威が検出されると、認証は失敗します。

次のように問題をトラブルシューティングできます:

  1. ユーザーに、マルチアカウント、アプリクローン、または仮想環境アプリケーションなどのソフトウェアやプラグインをデバイスからアンインストールするようアドバイスしてください。 その後、デバイスを初期の安全な環境に復元して再試行してください。

  2. テストデモのパッケージ名を使用しているかどうかを確認してください。 使用している場合は、ビジネスパッケージ名に変更してください。 これにより、プロジェクトまたはサービスのセキュリティポリシーによってリクエストがブロックされるのを防ぎます。

207

はい

公式データベースに対する顔認識が失敗しました。 人物が同一でないか、ライブ写真の品質が低い可能性があります。

説明

このエラーコードは、プロダクトによって検証される証明書のタイプが中国の ID カードであり、権威検証機能が有効になっている場合にのみ返されます。