すべてのプロダクト
Search

このプロダクト

    ID Verification:CheckResult

    ドキュメントセンター

    ID Verification:CheckResult

    最終更新日:Feb 08, 2026

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

    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 操作のデバッグと統合」で、API 操作の呼び出し方法、および OpenAPI Explorer で SDK とサンプルコードを取得する方法をご確認ください。

    この操作は OpenAPI Explorer でテストし、SDK サンプルコードを生成できます。

    リクエストパラメーター

    名前

    タイプ

    必須

    説明

    値の例

    MerchantBizId

    String

    はい

    お客様がカスタマイズする一意のビジネス ID です。後の問題特定やトラブルシューティングに役立ちます。最大 32 文字の英数字の組み合わせを使用してください。ID が一意であることを確認してください。

    説明

    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-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 format",
  "facePassed": "Y",
  "faceQuality": 95.45,
  "faceOcclusion": "N"
   "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

    Result.ExtIdInfo

    String

    証明書検知の結果に関する情報です。

    JSON フォーマットについては、右の例をご参照ください。詳細については、「ExtIdInfo」をご参照ください。

    {
  "ocrIdInfoData": {
    "01": {
      "ocrIdInfo": {
        "id_number": "083099003767",
        "full_name": "MAC PHAM HOÀNG DƯƠNG",
        "nationality": "Việt Nam",
        "date_of_expiry": "",
        "date_of_birth": "16/08/1999",
        "sex": "Nam"
      },
      "ocrIdPassed": "Y",
      "spoofInfo": {
        "spoofResult": "N"
      }
    },
    "02": {
      "ocrIdInfo": {
        "date_of_issue": "10/02/2022",
        "personal_identification": "Sẹo chấm C.2cm trên sau mèp phải"
      },
      "ocrIdPassed": "Y",
      "spoofInfo": {
        "spoofResult": "N"
      }
    }
  },
  "ocrIdPassed": "Y"
}

    Result.ExtSourceInfo

    String

    以下にデータソース検証結果の詳細を説明します。例としてインドネシアのデータソースを使用します。

    • govId, fullName, dob：比較スコアが 1.0 の場合は、公式データソースの情報と完全に一致することを示します。1.0 未満のスコアは不一致を示します。

    • selfiePhoto：比較スコアが 0.8 を超える場合は、公式データソースの情報と一致することを示します。0.8 以下のスコアは不一致を示します。

    • liveness：スコアが 0.95 を超える場合は、生体検知のリスクがあることを示します。

    • imgManipulationScore：スコアが 0.95 を超える場合は、イメージ改ざんのリスクがあることを示します。

    {
  "govId": 1.0,
  "fullName": 1.0,
  "dob": 0.9,
  "selfiePhoto": 0.8777,
  "liveness": 0.1152,
  "imgManipulationScore": 0.2253
}

    ExtFaceInfo

    名前

    タイプ

    説明

    例

    facePassed

    String

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

    • Y：合格

    • N：失敗

    Y

    faceComparisonScore

    Double

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

    99.99

    faceImg

    String

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

    Base64 フォーマット

    faceAttack

    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

    ExtIdInfo

    名前

    タイプ

    説明

    値の例

    ocrIdPassed

    String

    証明書 OCR 認識段階の最終結果です。

    • Y：合格

    • N：失敗

    N

    ocrIdInfoData

    Map<String,Object>

    証明書の詳細な OCR 情報です。キーは証明書のページ番号です。値の詳細については、「ocrIdInfoData」をご参照ください。

    `01` と `02` は、それぞれ証明書の表面と裏面 (または 2 ページ目) を示します。

    {
  "01": 
    "ocrIdInfo": {
      "expiryDate": "2030.01.01",
      "englishName": "SUN, xxx",
      "originOfIssue": "National Immigration Administration, People's Republic of China",
      "placeOfIssue": "Beijing",
      "sex": "Male",
      "name": "Sun X",
      "idNumber": "CGxxxxxxxx",
      "issueDate": "2024.12.01",
      "birthDate": "1992.12.01"
    },
    "ocrIdPassed": "Y",
    "spoofInfo": {
      "spoofResult": "N"
    }
  }
}

    ocrIdEditInfo

    String

    OCR 結果ページでユーザーが編集後に送信した証明書 OCR フィールド情報です。このフィールドは、クライアント構成で OCR 結果編集ページ (ShowOcrResult) が有効になっている場合に返されます。

    {
  "expiryDate": "2026-01-02",
  "originOfIssue": "Bureau of Exit and Entry Administration of the Ministry of Public Security",
  "englishName": "ZHANG SAN",
  "sex": "Male",
  "name": "Zhang San",
  "idNumber": "H11111115",
  "issueDate": "2013-01-02",
  "birthDate": "1990-02-21"
}

    ocrIdInfoData

    名前

    タイプ

    説明

    値の例

    idImage

    String

    証明書 OCR 写真の Base64 フォーマットです。リクエストで isReturnImage=Y を設定し、証明書 OCR プロセスが正常に完了した場合にこのフィールドが返されます。

    base64 フォーマット

    ocrIdPassed

    String

    このページの証明書 OCR 認識段階の結果です。

    • Y：合格

    • N：失敗

    N

    ocrIdInfo

    String

    証明書 OCR フィールド情報です。

    フィールドの詳細については、「証明書 OCR フィールド」をご参照ください。

    説明

    証明書 OCR プロセスが失敗した場合、このフィールドは空になります。

    {
  "expiryDate": "2030.01.01",
  "englishName": "SUN, xxx",
  "originOfIssue": "National Immigration Administration, People's Republic of China",
  "placeOfIssue": "Beijing",
  "sex": "Male",
  "name": "Sun X",
  "idNumber": "CGxxxxxxxx",
  "issueDate": "2024.12.01",
  "birthDate": "1992.12.01"
}

    spoofInfo

    String

    証明書のなりすまし防止検知の結果です。リスク結果とリスクタイプが含まれます。

    説明

    証明書検知は、Initialize 操作で IdSpoof を Y に設定した場合にのみ有効になります。

    それ以外の場合、spoofResult はデフォルトで N を返し、spoofType は空になります。

    • spoofResult：

      • Y：リスクが検知されました。

      • N：正常

    • spoofType：

      • SCREEN_REMARK：画面再撮影

      • PHOTO_COPY：コピー

      • TAMPER：改ざん

    {
 "spoofResult": "Y",
 "spoofType": ["SCREEN_REMARK"]
}

    応答コード

    HTTP ステータスコード

    コード

    メッセージの説明

    200

    Success

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

    400

    MissingParameter

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

    InvalidParameter

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

    TransactionIdInvalid

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

    403

    Forbidden.RAMUserAccessDenied

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

    Forbidden.AccountAccessDenied

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

    Throttling.Api

    API リクエストは速度制限のためブロックされています。

    404

    ProcessNotCompleted

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

    500

    InternalError

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

    503

    ServiceUnavailable

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

    ResultObject.SubCode のエラーコード

    エラーコード

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

    説明と推奨される理由

    200

    はい

    認証に合格しました。

    202

    はい

    国民 ID 番号が権威データソースにありません。

    204

    はい

    ライブネス顔認証の顔と自撮り写真が一致しません。これは、人物とドキュメントの不一致、または低品質のライブネス写真が原因である可能性があります。

    205

    はい

    生体検知でリスクが検出されました。

    206

    はい

    ビジネスポリシーによる制限です。セーフモードが有効な場合、認証デバイスと環境でセキュリティチェックが実行されます。リスクが検出された場合、認証は失敗します。

    トラブルシューティング手順：

    1. ユーザーに、デバイスからアプリクローンツール、パラレルスペースアプリ、仮想環境、または関連するプラグインをアンインストールするように促してください。デバイスを元の安全な環境に復元して、再試行してください。

    2. テストデモのパッケージ名を使用しているかどうかを確認してください。もしそうであれば、エンジニアリングまたはサービスのセキュリティポリシーによってブロックされるのを避けるために、ビジネス用のパッケージ名に変更してください。

    207

    はい

    自撮り写真が権威データソースの情報と一致しません。

    209

    はい

    権威データソースがタイムアウトしました。

    212

    はい

    ドキュメントの偽造防止検知でリスクが示されました。画面の再撮影 (画面や写真の撮影)、改ざん、コピーなどの高リスクな操作が検知されました。

    214

    はい

    個人情報 (国民 ID 番号、氏名、生年月日) が権威データソースの情報と一致しません。

    215

    はい

    個人情報 (国民 ID 番号、氏名、生年月日) も自撮り写真も、権威データソースのどのレコードとも一致しません。

    216

    はい

    権威データソースで ライブネス異常が検出されました。これは、インドネシアのデータソースでの検証中に、ExtScoureInfo フィールドの liveness 値が 0.95 を超えるか、imgManipulationScore 値が 0.95 を超える場合に発生する可能性があります。

    217

    はい

    自撮り写真の品質が要件を満たしていません。

    218

    はい

    eKYC プロセスは合格しましたが、権威データソースの使用に失敗しました。