录入身份信息

POST

/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	检查请求参数是否为空

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

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: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identity_name": "张三",
    "identity_code": "4xxxxxxxx",
    "mobile": "13xxxxxxx"
}'

响应示例

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

修改于 2025-10-21 08:29:35

获取指标项

上传人脸基准图片

录入身份信息

错误码#

请求参数

返回响应

错误码