更新人员

更新时间：2023-06-15 05:23:26

本文介绍更新人员的 API。

接口描述

下发更新人员指令给门禁，在门禁设备端更新人员信息。

接口地址

PUT: /v1.0/access-control/{device_id}/persons/{person_id}

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	涂鸦设备 ID。
person_id	String	uri	true	人员 ID。

body 说明

参数名	类型	是否必填	说明
name	String	false	人员姓名。
id_card	String	false	证件 ID。
phone	String	false	手机号码。
person_floor	Integer	false	人员所在楼层。
secret_key	String	false	人员密钥。
refresh_time	Long	false	二维码刷新时间，单位毫秒。
begin_time	Long	false	有效期开始时间，单位毫秒。
end_time	Long	false	有效期结束时间，单位毫秒。
door_time_rule_list	List	false	日程时间规则。
extend	String	false	扩展信息。

door_time_rule_list 说明

参数名	类型	是否必填	说明
rule_name	String	false	日程时间规则名称。
period	String	false	可通⾏时间周期，json 字符串。例如： [{"weekDay":1,"weekTime":[{"start":"32400000","end":"64800000"}]},{"weekDay":2,"weekTime":[{"start":"68400000","end":"75600000"}]}]。
allowed_date	String	false	可通⾏时间段，json 字符串。例如：[{"start":"1571587200000","end":"1864569600000"},{"start":"1573022801885","end":"1864569600000"}]。
denied_date	String	false	不可通⾏时间段，json 字符串。例如：[{"start":"1571587200000","end":"1864569600000"},{"start":"1573022801885","end":"1864569600000"}]。

返回参数

参数名	类型	说明
result	CmdIssueResultResponse	返回结果。

result 说明

参数名	类型	说明
sn	String	指令记录 ID。

请求示例

PUT: /v1.0/access-control/6ce****/persons/123****

{
  "begin_time": 1582959882104,
  "end_time": 1661666512292,
  "id_card": "330****",
  "name": "张三",
  "phone": "135****",
  "person_floor": 5,
  "secret_key": "abc123***",
  "refresh_time": 300000
}

返回示例

{
    "result": {
        "sn": "133****"
    },
    "t": 1561456817168,
    "success": true
}

错误码

参考错误码。

上一篇新增人员

下一篇门禁人脸管理