新建

添加新人员,必填字段为name;type不填默认为1(员工);avatar为base64后的图片数据,要求原图像为JPG或PNG格式；当同时填入avatar和feature字段时，feature字段值作为入库特征值，而avatar仅做为展示头像。当字段 avatar ， feature 同时为空字符串或者为NULL时，清除人员特征数据。

支持创建和更新人员信息，如user_id不存在则创建人员信息，如user_id存在则更新人员信息.

请求路径

/v1/user

请求方式

POST

• 请求体: application/json

字段	类型	必填	字段释义
user_id	String	Y	由提交端设置的唯一标识,不可重复, 长度上限128字节
name	String	Y	人员名称,长度须大于0小于等于128
type	Int	N	人员类型,取值 1：员工 2：访客 5: 黑名单; 默认1,创建后不可修改
avatar	String	N	人员头像,要求base64编码,上限10MB;存在feature时,该字段可不填
feature	String	N	人员特征值,上限10KB,存在avatar时,该字段可不填,avatar与feature同时有值优先feature
ic_number	String	N	IC卡号,上限128字节
id_number	String	N	身份证号,上限128字节
job_number	String	N	工号,上限128字节
pin	String	N	pin code,上限128字节
guest_time_start	Int	N	访客开始时间，毫秒级Unix时间戳
guest_time_end	Int	N	访客结束时间，毫秒级Unix时间戳
groups	String array	N	绑定人员组的列表, 绑定的组类型不可互斥
is_admin	boolean	N	是否启用管理员权限，用于设备管理界面的刷脸认证,默认false
remark	String	N	备注,上限256字节
create_at	Int	N	数据创建时间，服务端下发,请勿填写
update_at	Int	N	数据修改时间，服务端下发,请勿填写

请求示例:

添加一个人员，user_id设置为 3，name设置为张三，type设置为 1(员工组),且绑定通行组的1和2。

/v1/user

{
  "user_id":"3",
  "name": "张三",
  "avatar": "/9j/2wCEAAoHBwgHBgoICAgLCgoLDhgQDg0NDh0VFhEYIx8lJCIfIiEmKzcvJik0KSEiMEExNDk7Pj4",
  "type": 1,
  "groups": ["1","2"]
}

返回示例

{
  "data": {
        "user_id":"3",
        "name": "张三",
        "avatar": "/9j/2wCEAAoHBwgHBgoICAgLCgoLDhgQDg0NDh0VFhEYIx8lJCIfIiEmKzcvJik0KSEiMEExNDk7Pj4",
        "type": 1,
        "ic_number":"",
        "job_number":"",
        "id_number":"",
        "pin":"",
        "groups": ["1","2"],
        "is_admin":false,
        "remark":"",
        "create_at": 1660222970940,
        "update_at": 1660222970940
  },
  "code": 200,
  "msg": "OK"
}