8. 偶像端 API 8.31.2 上传身份证人像面并识别

Table of Contents

8.31.2 上传身份证人像面并识别

POST /tieup/api/v1/user/identity/id-card-drafts/front
Authorization: Bearer <access_token>
X-App-Platform: android
Content-Type: multipart/form-data

鉴权：需要 Authorization: Bearer <access_token>。X-App-Platform 必填，只支持 ios 或 android。

请求字段：

字段 类型 必填 说明
front_image file 是 身份证人像面原图；仅支持 JPG/JPEG/PNG，单张最大 3MB

服务端将图片放入随机临时文件，调用百度身份证 OCR 后立即删除，不上传七牛或保存图片地址。服务端开启 PS、风险、清晰度、完整性和遮挡检测，并校验 OCR 姓名、18 位身份证号、出生日期及校验码。姓名和身份证号只加密保存在服务端，不返回 APP。上传新人像面代表主动重新认证：服务端先取消当前 preparing/processing 会话并清除旧 Token、Access Token、姓名及身份证密文，再创建新 OCR 草稿；当前已有有效实名不会阻止上传，新认证成功前旧实名继续有效。

图片可用完整响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "identity_draft_no": "BID202608031400009C03D8E8979C71F3EAA1",
    "usable": true,
    "ready_for_face_verification": false,
    "unusable_code": null,
    "unusable_reason": null,
    "expires_at": "2026-08-03 14:30:00"
  }
}

图片不可用完整响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "identity_draft_no": "BID202608031400009C03D8E8979C71F3EAA1",
    "usable": false,
    "ready_for_face_verification": false,
    "unusable_code": "image_blurred",
    "unusable_reason": "身份证照片模糊，请重新拍摄",
    "expires_at": "2026-08-03 14:30:00"
  }
}

响应字段：

字段 类型 说明
data.identity_draft_no string 服务端身份证 OCR 草稿号，上传国徽面和创建人脸认证时使用
data.usable bool 本次图片是否通过服务端 OCR、质量和风险校验
data.ready_for_face_verification bool 人像面接口固定为 false，正反面均通过后才为 true
data.unusable_code string/null 图片不可用的稳定原因码，可用于前端分支
data.unusable_reason string/null 图片不可用的安全中文提示
data.expires_at string 草稿过期时间，创建后或重传人像面后 30 分钟

常见 unusable_code 包括 wrong_side、non_idcard、image_blurred、over_exposure、over_dark、incomplete_card、covered_card、copy_card、scan_card、temporary_card、screen_card、screenshot_card、edited_card 和 invalid_identity_fields。用户认为识别错误时只能重新拍摄，不能手工修改姓名或身份证号。重传人像面会清除旧国徽面结果，避免新旧证件混用。