上传人脸基准图片
无源人脸比对流程,开发者后台通过调用此接口将基准图片上传到飞书后台,做检测时的对比使用。
Note 无源人脸比对接入需申请白名单,接入前请联系飞书开放平台工作人员,邮箱:open-platform@bytedance.com。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/face_verify/v1/upload_face_image |
| HTTP Method | POST |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"multipart/form-data" |
查询参数
用户标识open_id与employee_id二选其一,同时传入取open_id,open_id必须与tenant_access_token对应的应用和租户相同,employee_id必须与tenant_access_token的租户相同。
| 参数 | 格式 | 必须 | 说明 | 类型 |
|---|---|---|---|---|
| open_id | string | 否 | 用户应用标识, 与employee_id二选其一 | URL 参数 |
| employee_id | string | 否 | 用户租户标识, 与open_id二选其一 | URL 参数 |
Note
open_id和employee_id(也称user_id)的获取方式可以参考文档:如何获取不同的用户 ID
请求体
| 参数 | 格式 | 必须 | 说明 | 类型 |
|---|---|---|---|---|
| image | file | 是 | 带有头像的人脸照片 | 请求 body |
响应
响应体
| 参数 | 说明 |
|---|---|
| code | 返回码,非0为失败 |
| msg | 返回信息,返回码的描述 |
| data | 业务数据 |
| ∟face_uid | 人脸图片用户Uid,需返回给应用小程序,作为小程序调起人脸识别接口的uid参数 |
响应体示例
json
{
"code": 0,
"msg": "ok",
"data": {
"face_uid": "ou_3a85bc15f186865bf03d9fa522878a53"
}
}错误码
| 错误码 | 描述 | 排查建议 |
|---|---|---|
| 10100 | invalid request | 检查参数是否为空,权限是否接入 |
| 10101 | internal error | 建议重试 |
