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,
    "invalid_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,
    "invalid_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": 200,
  "message": "成功",
  "data": {
    "status": 3,
    "status_label": "未实名认证",
    "real_name_masked": null,
    "id_card_type": "idcard",
    "id_card_masked": null,
    "verified_at": null,
    "failed_reason": "身份证已过有效期，请重新认证",
    "invalid_reason": "identity_expired",
    "flow_status": "identity_expired",
    "next_action": "upload_front",
    "identity_draft_no": null,
    "draft_expires_at": null,
    "verification_no": null,
    "verify_token": null,
    "verification_expires_at": null
  }
}

响应字段：

字段 类型 说明
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.invalid_reason string/null 实名档案失效原因：identity_expired=身份证过期、identity_reassigned=身份证被其他账号重新认证、expiry_missing=历史实名缺少证件有效期；普通流程失败时为空
data.flow_status string 当前流程状态：not_started、draft、draft_ready、preparing、processing、passed、failed、expired、cancelled、identity_expired、identity_reassigned 或 expiry_missing
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=2；认证失败、身份证过期、被其他账号重新认证或历史档案缺少有效期时为 status=3。已实名用户重复认证期间继续返回旧实名的 status=2 和脱敏字段，同时通过 flow_status、next_action 返回新流程恢复信息；新认证失败或中断不会取消旧实名。APP 启动、杀进程恢复或换设备登录后必须先调用本接口，并按 next_action 继续。姓名、身份证号、身份证有效期原文、百度 access_token 和后台配置永不通过本接口返回。