录入身份信息

POST

/open-apis/human_authentication/v1/identities

自建应用商店应用

该接口用于录入实名认证的身份信息，在唤起有源活体认证前，需要使用该接口进行实名认证。

实名认证接口会有计费管理，接入前请联系飞书开放平台工作人员，邮箱：open-platform@bytedance.com。

仅通过计费申请的应用，才能在开发者后台查找并申请该接口的权限。

错误码

HTTP状态码	错误码	描述	排查建议
400	1291001	upload fail	上传失败，可以重试
400	1291002	name mismatch	检查用户绑定的姓名是否匹配
400	1291003	code mismatch	检查用户绑定的身份证号是否匹配
400	1291004	mobile mismatch	检查用户绑定的手机号是否匹配
400	1291010	invalid request	检查请求参数是否为空

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/human_authentication/v1/identities?user_id=ou_2eb5483cb377daa5054bc6f86e2089a5&user_id_type=open_id' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identity_name": "张三",
    "identity_code": "4xxxxxxxx",
    "mobile": "13xxxxxxx"
}'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "verify_uid": "ou_2eb5483cb377daa5054bc6f86e2089a5"
  }
}

请求参数

Query 参数

user_id

string

必需

用户的唯一标识（使用的ID类型见下一参数描述，不同ID类型的区别和获取，参考文档：如何获得 User ID、Open ID 和 Union ID？） 示例值： "ou_2eb5483cb377daa5054bc6f86e2089a5"

示例值:

ou_2eb5483cb377daa5054bc6f86e2089a5

user_id_type

string

可选

用户ID类型示例值： "open_id" 可选值有： open_id：用户的open id union_id：用户的union id user_id：用户的user id 默认值： open_id 当值为 user_id，字段权限要求：获取用户 user ID

示例值:

open_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

identity_name

string

必需

姓名示例值： "张三"

identity_code

string

必需

身份证号示例值： "4xxxxxxxx"

mobile

string

必需

手机号示例值： "13xxxxxxx"

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

verify_uid

string

必需

用户绑定实名身份的uid

修改于 2023-02-07 07:52:09

获取指标项

上传人脸基准图片

录入身份信息

错误码#

请求参数

返回响应

错误码