8. 偶像端 API 8.31.1 查询实名认证状态

Table of Contents

8.31.1 查询实名认证状态

GET /tieup/api/v1/user/identity

鉴权：需要 Authorization: Bearer <access_token>。

完整响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "status": 2,
    "status_label": "已认证",
    "real_name_masked": "测***",
    "id_card_type": "idcard",
    "id_card_masked": "110***********002X",
    "verified_at": "2026-08-03 14:30:00",
    "failed_reason": null,
    "flow_status": "passed",
    "next_action": "none",
    "identity_draft_no": null,
    "draft_expires_at": null,
    "verification_no": null,
    "verify_token": null,
    "verification_expires_at": null
  }
}

有效 processing 会话完整响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "status": 1,
    "status_label": "待核验",
    "real_name_masked": null,
    "id_card_type": "idcard",
    "id_card_masked": null,
    "verified_at": null,
    "failed_reason": null,
    "flow_status": "processing",
    "next_action": "continue_face_verification",
    "identity_draft_no": "BID202608041201093DFCD9FF21D2C043890F",
    "draft_expires_at": "2026-08-04 12:31:09",
    "verification_no": "BFV202608041201093DFCD9FF21D2C043890F",
    "verify_token": "Yz9rWITm4vak16PBAh5x8oG7",
    "verification_expires_at": "2026-08-04 14:01:09"
  }
}

响应字段：

字段 类型 说明
code int 业务状态码，成功固定 200
message string 响应说明
data.status int 0=未发起、1=待核验、2=已认证、3=认证失败或过期
data.status_label string 状态中文说明
data.real_name_masked string/null 百度认证成功后保存的脱敏姓名
data.id_card_type string/null 当前固定为 idcard；未发起时可能为空
data.id_card_masked string/null 百度认证成功后保存的脱敏身份证号
data.verified_at string/null 认证通过时间，格式 YYYY-MM-DD HH:mm:ss
data.failed_reason string/null 失败或过期时的安全可展示原因
data.flow_status string 当前流程状态：not_started、draft、draft_ready、preparing、processing、passed、failed、expired 或 cancelled
data.next_action string APP 下一步动作：upload_front、upload_back、create_face_verification、continue_face_verification 或 none
data.identity_draft_no string/null 当前可继续流程关联的 OCR 草稿号；没有可用草稿时为空
data.draft_expires_at string/null 当前或关联草稿的过期时间，格式 YYYY-MM-DD HH:mm:ss；processing 恢复不以此字段判断有效性
data.verification_no string/null 当前或最近一次 Tieup 业务认证号
data.verify_token string/null 仅有效 processing 会话返回原百度 SDK Token；其他状态固定为空
data.verification_expires_at string/null 人脸会话核验窗口结束时间，格式 YYYY-MM-DD HH:mm:ss

未发起认证时 status=0；草稿、准备中和处理中统一保留兼容口径 status=1；过期、取消或核验失败统一以 status=3 返回；已实名为 status=2。APP 启动、杀进程恢复或换设备登录后必须先调用本接口，并按 next_action 继续：processing 可直接使用原 verification_no、verify_token 和 verification_expires_at 恢复百度 SDK，即使关联草稿已消费或 draft_expires_at 已到期也不得阻断；preparing 使用 identity_draft_no 重调创建接口，由服务端使用原会话继续上报两要素；失败、过期或取消必须重新上传人像面。姓名、身份证号、百度 access_token 和后台配置永不通过本接口返回。