すべてのプロダクト
Search

このプロダクト

    ID Verification:CheckResult

    ドキュメントセンター

    ID Verification:CheckResult

    最終更新日:Feb 08, 2026

    CheckResult 操作は、本人確認の結果を取得します。このトピックでは、CheckResult 操作のリクエストパラメーターとレスポンスパラメーターについて説明します。

    API リファレンス

    • 操作名：CheckResult

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

    • 概要：コールバック通知を受信した後、ご利用のサーバーからこの操作を呼び出して、対応する確認結果を取得します。

      重要

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

    • この API 操作には専用の QPS 制限があります。詳細については、「ID Verification サーバーサイド API 操作の QPS 制限」をご参照ください。

    • サービスエンドポイント：

      説明

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

      • 中国以外からのアクセスの最適化に関する提案：中国以外のネットワーク環境は複雑になる可能性があります。統合ソリューションを最適化し、ネットワーク遅延を削減し、リクエストの失敗を最小限に抑えるには、「サーバーサイドのネットワーク遅延の分析と最適化」をご参照ください。

      シンガポール

      • パブリックネットワーク：cloudauth-intl.ap-southeast-1.aliyuncs.com

      • 内部ネットワーク：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

      インドネシア

      • パブリックネットワーク：cloudauth-intl.ap-southeast-5.aliyuncs.com

      • 内部ネットワーク：cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

      中国 (香港)

      • パブリックネットワーク：cloudauth-intl.cn-hongkong.aliyuncs.com

      • 内部ネットワーク：cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

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

    説明

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

    この操作は OpenAPI Explorer で直接実行してテストし、この操作の SDK コード例を生成できます。SDK コード例。

    リクエストパラメーター

    名前

    タイプ

    必須

    説明

    値の例

    MerchantBizId

    String

    はい

    お客様のビジネスで定義する一意の識別子です。後で問題をトラブルシューティングするために使用します。

    値は、最大 32 文字の英字と数字の組み合わせである必要があります。一意性を確保してください。

    説明

    Alibaba Cloud はこのフィールドの一意性を検証しません。

    トレーサビリティを向上させるために、一意性を確保してください。

    e0c34a77f5ac40a5aa5e6ed20c35****

    TransactionId

    String

    はい

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

    重要

    改ざんを防ぐため、Initialize 操作を呼び出す際には、サーバーに保存されている 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.ExtIdInfo

    String

    NFC を使用して読み取られたドキュメントに関する情報。

    詳細については、「ExtIdInfo」をご参照ください。

    {
  "nfcIdImage": "<ImageBase64Code>",
  "nfcIdInfo": {
    "passportNo": "EP1875674",
    "expiryDate": "16-02-2035",
    "nationality": "CHN",
    "surname": "WU",
    "givenname": "DONGSHENG",
    "countryCode": "CHN",
    "sex": "M",
    "birthDate": "04-12-1991"
    }
}

    リターンコード

    HTTP ステータスコード

    Code

    メッセージの説明

    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 エラーコード

    説明

    Subcode は、さまざまなプロダクトソリューションや統合メソッドに基づいて返されます。詳細については、次の表をご参照ください。

    適用可能なソリューション

    エラーコード

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

    説明と推奨される理由

    一般

    200

    はい

    認証に合格しました。

    • ID_OCR 純粋サーバーサイド統合 (DocOcr)

    • ID_OCR_MAX

    211

    はい

    証明書イメージの品質または解像度が要件を満たしていないか、イメージ自体が不完全です。証明書の顔写真側が鮮明で、露出が正常で、遮蔽がなく完全であり、大きな角度のずれがないことを確認してください。

    • ID_OCR アプリ (SDK) 統合

    • ID_OCR Web (SDK) 統合

    • ID_OCR_MAX

    212

    はい

    証明書の偽造防止検出でリスクが示されました。再撮影、改ざん、コピーなどのリスクの高い操作が行われた可能性があります。

    • ID_OCR 純粋サーバーサイド統合 (DocOcr)

    • ID_OCR_MAX

    213

    はい

    指定された証明書タイプが検出されなかった (認識モード) か、証明書タイプを識別できませんでした (分類モード)。

    鮮明で完全な、角度が正常な証明書イメージをアップロードすることを推奨します。

    ExtIdInfo

    名前

    タイプ

    説明

    例

    nfcIdImage

    String

    NFC を使用してドキュメントから読み取られた顔写真。Base64 フォーマットでエンコードされています。

    このフィールドは、isReturnImage を Y に設定し、確認が正常に完了した場合にのみ返されます。

    base64

    nfcIdInfo

    String

    NFC を使用してドキュメントから読み取られたフィールド。

    現在、グローバルパスポートのみをサポートしています。フィールドの詳細は次の表に記載されています。

    グローバルパスポート

    フィールド

    タイプ

    説明

    surname

    String

    姓

    givenname

    String

    名

    sex

    String

    性別

    birthDate

    String

    生年月日

    passportNo

    String

    パスポート番号

    nationality

    String

    国籍

    expiryDate

    String

    有効期限

    countryCode

    String

    国コード