添加人员
概述
- 此 API 用于向企业中添加人员，支持同时添加人脸照片；
授权方式
| 数据维度授权 | 企业级授权 | 此 API 为企业级授权，企业级授权和代理商级授权的授权账号均可以调用此 API。请参考 授权方式。 |
|---|
| 接口维度授权 | 默认授权 | 此 API 为默认授权，您无需为您的授权账号额外申请接口维度授权就可以调用。请参考 授权方式。 |
|---|
注意事项
- 根据 2021年8月1日生效实施的《最高人民法院关于审理使用人脸识别技术处理个人信息相关民事案件适用法律若干问题的规定》，您需要和猎户星空签定有关人脸识别的《数据委托处理协议》后才能调用此 API；
- 详情请咨询猎户星空售前技术支持；
请求
请求域名
请求协议
| HTTP URL 路径 | /v1/person/add_person |
|---|---|
| HTTP Method | POST |
| Content-Type | multipart/form-data |
请求体参数
| 参数 | 类型 | 必填 | 参数说明 |
|---|---|---|---|
| ov_corpid | string | 是 | 人员所属企业 id |
| person | jsonString | 是 | person 人员信息对象 json 串，请参考 person - 人员信息对象。例如：{"full_name":"姓名"} |
| skip_check_same | int | 否 | 是否跳过检测重复的人脸，默认是不跳过（即检测）。0：不跳过（即检测）。1：跳过（即不检测）。如果不想添加人脸照片请在不传递人脸照片参数的同时把此参数传递成 1。 |
| face_content_1 | file | 否 | 第一张人脸照片。只允许 jpeg/png 类型的图片，文件扩展名必须是 jpg/jpeg/png。需要使用 Content-Type: multipart/form-data 的标准上传文件的方式提交。 |
| face_content_2 | file | 否 | 第二张人脸照片。要求同上。 |
| face_content_3 | file | 否 | 第三张人脸照片。要求同上。 |
person - 人员信息对象
| 参数 | 类型 | 必填 | 参数说明 |
|---|---|---|---|
| full_name | string | 是 | 姓名 |
| gender | string | 否 | 性别 0：未知 1：男 2：女 |
| extinfo | string | 否 | 自定义扩展信息，猎户星空会原样存储并原样送出。长度不能超过 512 个字。 |
请求 cURL 示例
# 请根据您的区域替换域名 curl --location "https://openapi.orionstar.com/v1/person/add_person" \ --header 'Authorization: Bearer YOUR-ACCESS-TOKEN' \ --form 'ov_corpid=test_ov_corpid' \ --form 'person={"full_name":"姓名"}' \ --form 'face_content_1=@face1.jpeg' \ --form 'face_content_2=@face2.jpeg'
响应
公共响应体
| 参数 | 类型 | 参数说明 |
|---|---|---|
| code | int | 错误代码。0 是成功，非 0 是失败，请参考 错误代码。 |
| msg | string | 错误描述，当失败的时候会给出具体的错误描述。 |
| req_id | string | 日志跟踪 id，当遇到问题需要猎户星空协助查问题时候，请提供此跟踪 id 值。 |
| data | object | 业务数据 data 对象，详见下述 响应体 data 对象。 |
响应体 data 对象
| 参数 | 类型 | 参数说明 |
|---|---|---|
| person_id | string | 人员 id |
响应体示例
{ "code": 0, "msg": "", "data": { "person_id": "test_person_id" } }