Skip to content

上传人脸基准图片

无源人脸比对流程,开发者后台通过调用此接口将基准图片上传到飞书后台,做检测时的对比使用。

Note 无源人脸比对接入需申请白名单,接入前请联系飞书开放平台工作人员,邮箱:open-platform@bytedance.com。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/face_verify/v1/upload_face_image
HTTP MethodPOST

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"multipart/form-data"

查询参数

用户标识open_id与employee_id二选其一,同时传入取open_id,open_id必须与tenant_access_token对应的应用和租户相同,employee_id必须与tenant_access_token的租户相同。

参数格式必须说明类型
open_idstring用户应用标识, 与employee_id二选其一URL 参数
employee_idstring用户租户标识, 与open_id二选其一URL 参数

Noteopen_idemployee_id(也称user_id)的获取方式可以参考文档:如何获取不同的用户 ID

请求体

参数格式必须说明类型
imagefile带有头像的人脸照片请求 body

响应

响应体

参数说明
code返回码,非0为失败
msg返回信息,返回码的描述
data业务数据
 ∟face_uid人脸图片用户Uid,需返回给应用小程序,作为小程序调起人脸识别接口的uid参数

响应体示例

json
{ 
    "code": 0, 
    "msg": "ok", 
    "data": {
        "face_uid": "ou_3a85bc15f186865bf03d9fa522878a53"
    }
}

错误码

错误码描述排查建议
10100invalid request检查参数是否为空,权限是否接入
10101internal error建议重试

内容来源:飞书开放平台 · 自动爬取整理