全部产品
Search

搜索本产品

    ID Verification：全链路认证日志查询

    文档中心

    ID Verification：全链路认证日志查询

    更新时间：Sep 18, 2026

    ID Verification 产品支持全链路日志监控，未完成认证的人脸识别过程，也可通过 TransactionId 自助查询，查询结果可用于分析用户流失原因。此接口不涉及计费。

    接口说明

    查询认证的完整链路日志。

    重要

    • 此接口仅可查询有客户端接入的方案日志，不支持纯服务端接入方案。

    • 采用认证的端侧 SDK 版本需在 1.2.6 及以上（建议使用最新版），Web SDK 需使用最新版。

    • 由于认证过程中日志上报按照操作时间异步上传，请在认证TransectionID的30分钟有效期失效后查询。

    • ID Verification服务记录默认存储30天，超期系统自动删除，请您在认证结束后的30天内查询认证记录。

    • 接口名：CheckVerifyLog

    • 请求方法：POST

    • 传输协议：HTTPS

    • 服务地址：

      说明

      • 内网指的是阿里云同地域产品之间的内部通信网络，如果您的业务服务器部署在阿里云的对应地域，可以通过内网域名访问 ID Verification 服务，以获得更安全、稳定的网络通信质量。

      • ID Verification不同产品方案支持的Region不同，数据之间相互隔离，您需要选择数据所在Reigon下的接口域名，才能成功访问数据。

      新加坡

      • 公网：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

    在线调试和集成

    说明

    在调试和集成前，请确保您已完整阅读使用OpenAPI文档，充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

    您可以在OpenAPI Explorer中直接运行本接口进行调试，并生成本接口的SDK代码示例。

    请求参数

    名称

    类型

    是否必选

    描述

    示例值

    MerchantBizId

    String

    是

    您自定义的业务唯一标识，用于后续排查问题定位。支持长度为32位的字母和数字的组合，请确保唯一。

    说明

    阿里云服务器不会对该字段的值进行唯一性检查。为了更好地跟踪，强烈建议保证字段唯一性。

    e0c34a77f5ac40a5aa5e6ed20c******

    TransactionId

    String

    是

    整个认证流程的唯一标识。该值需要调用 Initialize接口 获取。

    80414a5e6ed20c37ac40a7f55a******

    返回参数

    名称

    类型

    描述

    示例

    RequestId

    String

    请求ID。

    {
  "RequestId": "A180B706-587F-3F53-9861-8A2E70F802D7",
  "Message": "success",
  "Code": "Success",
  "Result": {
    "Passed": "Y",
    "VerifyStatus": "0",
    "LogStatisticsInfo": "{\"faceOverTimes\":0,\"hasFaceOverTimes\":false,\"hasFacePermissionRefuse\":false,\"hasOcrEdit\":false,\"hasOcrEditOverTimes\":false,\"hasOcrOverTimes\":false,\"hasOcrPermissionRefuse\":false,\"ocrEditOverTimes\":0,\"ocrEditTimes\":0,\"ocrOverTimes\":0,\"pageStayTimeInfo\":{\"LOADING\":\"322\",\"OCR_SCAN\":\"8237\",\"OCR_RESULT\":\"2257\",\"FACE\":\"14687\"}}",
    "InterruptPage": "OCR识别结果编辑页面",
    "InterruptPageEn": "OCR_RESULT",
    "LogInfo": [
      "2025-04-09 17:27:08 Loading进入页面",
      "2025-04-09 17:27:08 Loading阶段结束",
      "2025-04-09 17:27:08 用户进入OCR页面",
      "2025-04-09 17:27:16 OCR认证阶段结束",
      "2025-04-09 17:27:16 用户进入OCR编辑页面",
      "2025-04-09 17:27:19 OCR编辑阶段结束",
      "2025-04-09 17:27:19 用户进入活体页面",
      "2025-04-09 17:27:33 活体检测阶段结束"
    ],
    "LogInfoEn": [
      "2025-08-13 18:33:44 LOADING_ENTER",
      "2025-08-13 18:33:45 LOADING_EXIT",
      "2025-08-13 18:33:45 GUIDE_PAGE_SHOW",
      "2025-08-13 18:33:46 GUIDE_PAGE_LEAVE",
      "2025-08-13 18:33:46 OCR_ENTER",
      "2025-08-13 18:33:51 TIME_OUT_ALERT_APPEAR",
      "2025-08-13 18:33:54 TIME_OUT_ALERT_CLOSE",
      "2025-08-13 18:33:54 TIME_OUT_RETRY_BTN",
      "2025-08-13 18:33:59 TIME_OUT_ALERT_APPEAR",
      "2025-08-13 18:34:11 TIME_OUT_ALERT_CLOSE",
      "2025-08-13 18:34:11 TIME_OUT_RETRY_BTN",
      "2025-08-13 18:34:16 TIME_OUT_ALERT_APPEAR",
      "2025-08-13 18:34:17 TIME_OUT_ALERT_CLOSE",
      "2025-08-13 18:34:17 TIME_OUT_EXIT_BTN",
      "2025-08-13 18:34:17 OCR_EXIT"
    ],
    "SubCode": "200",
    "VerifyErrorCode": "1000"
  }
}

    Code

    String

    返回码。

    Message

    String

    返回Code的详细描述。

    Result

    Object

    日志内容，参数详细说明见下文Result表。

    Result

    名称

    类型

    是否必含

    描述

    VerifyStatus

    String

    是

    认证状态，取值：

    • 0：认证完成

    • 1：认证中断

    • 2：未开始认证

    LogInfo

    List<String>

    否

    SDK运行链路日志详情，格式：

    [

    • 时间 - 启动XX页面

    • 时间 - 启动相机权限

    • 时间 - 点击同意并关闭相机权限

    • 时间 - 启动活体重试页面

    • 时间 - 用户点击了重试

    • 时间 - 炫彩活体开始（仅开启炫彩活体检测时涉及）

    • 时间 - 炫彩活体结束（仅开启炫彩活体检测时涉及）

    • 时间 - 用户完成客户端刷脸进入loading

    • 时间 - loading完成SDK退出

    ]

    LogInfoEn

    List<String>

    否

    SDK运行链路日志详情，英文取值。

    此字段格式同LogInfo。

    Passed

    String

    否

    说明

    仅当 VerifyStatus = 0 时返回。

    认证最终结果，取值：

    • Y：通过

    • N：不通过

    SubCode

    String

    否

    说明

    仅当 VerifyStatus = 0 时返回。

    认证结果描述，返回值请参考使用的认证方案接口文档中的SubCode描述。

    说明

    例如，使用了 eKYC - Web SDK 方案进行了认证，则需参考 eKYC - Web SDK - CheckResult 接口文档中的 SubCode 描述。

    InterruptPage

    String

    否

    认证中断最后停留页面，取值：

    • 页面未启动

    • loading页面

    • 引导页面

    • OCR拍摄证件页面

    • OCR识别结果编辑页面

    • 活体检测页面

    • NFC信息输入页面

    • NFC读取页面

    InterruptPageEn

    String

    否

    认证中断最后停留页面，英文取值：

    当然，以下是将这些取值转换为无序列表的形式：

    • LOADING

    • GUIDE

    • FACE

    • OCR_SCAN

    • OCR_RESULT

    • NFC_INPUT

    • NFC_READ

    VerifyErrorCode

    String

    否

    认证中断错误码：

    • 1000： 用户完成了刷脸过程，认证建议结果为通过。

    • 1001： 用户完成了刷脸过程，认证建议结果为未通过。

    • 1002： 系统错误。

    • 1003： SDK初始化失败，请确认客户端时间是否正确。

    • 1004： 相机权限错误。

    • 1005： 网络错误。

    • 1006： 用户退出。

    • 1007： TransactionId无效。

    • 1009： 客户端时间戳错误。

    • 1011： 提交证件类型错误。

    • 1012： 识别出的证件关键信息缺失或格式校验失败。

    • 1013： 图片质量不佳。

    • 1014： 错误次数超出上限。

    • 1015： 安卓系统版本过低。

    • 1016： 未获取到相机权限。

    • 9999： 疑似认证进程中断。

    LogStatisticsInfo

    String

    否

    SDK运行日志统计详情 ，JSON字符串格式，内容详见下文LogStatisticsInfo 表 。

    ExtInfo

    String

    否

    扩展字段（预留）

    LogStatisticsInfo

    名称

    类型

    含义

    示例

    pageStayTimeInfo

    Map<String,Long>

    页面停留时长（单位毫秒），页面：

    • LOADING：加载页面

    • GUIDE：引导页面

    • OCR_SCAN：OCR页面

    • OCR_RESULT：OCR编辑页面

    • FACE：人脸检测页面

    说明

    停留时长指每一个页面从渲染展示到跳转至下一个页面或者关闭所经历的时长。

    {
 "LOADING": "2051",
 "OCR_SCAN": "127238",
 "OCR_RESULT": "1897",
 "FACE": "12371"
}

    hasFaceOverTimes

    Boolean

    活体检测过程中，是否有弹出重试弹窗。

    true

    faceOverTimes

    Long

    活体检测过程中，用户点击重试次数。

    2

    hasOcrOverTimes

    Boolean

    OCR是否有重试：

    是否存在拍摄证件提交服务端验证不通过，用户点击重拍提交。

    false

    ocrOverTimes

    Long

    OCR拍摄证件过程中，用户点击重试次数。

    0

    hasOcrEdit

    Boolean

    在OCR页面中停留时，是否有点击编辑字段信息。

    true

    ocrEditTimes

    Long

    OCR编辑次数：

    用户编辑点击提交服务端校验计一次。

    1

    hasOcrEditOverTimes

    Boolean

    OCR编辑是否有重试

    false

    ocrEditOverTimes

    Long

    OCR编辑重试次数

    0

    hasOcrPermissionRefuse

    Boolean

    OCR是否被相机拒绝权限

    false

    hasFacePermissionRefuse

    Boolean

    活体检测是否被相机拒绝权限

    false

    返回码

    HTTP状态码

    Code

    Message描述

    200

    Success

    请求成功。

    400

    MissingParameter

    参数不能为空。

    InvalidParameter

    非法参数。

    TransactionIdInvalid

    无效Transaction id。

    403

    Forbidden.RAMUserAccessDenied

    需要给RAM用户授予AliyunAntCloudAuthFullAccess的操作权限。更多信息，请参见授权RAM用户访问服务。

    Forbidden.AccountAccessDenied

    确保您开通了ID verifycation，并且保证账户未欠费。

    Throttling.Api

    API限流拦截。

    404

    ProcessNotCompleted

    整个认证流程未完成。

    500

    InternalError

    系统内部错误，请反馈工程师排查。

    503

    ServiceUnavailable

    服务不可用，请反馈工程师排查。