云服务 API 参考设备高级服务垂直品类硬件 API行业三方设备能力门禁开放能力门禁用户管理新增人员

新增人员

更新时间：2023-06-20 14:54:10下载pdf

本文介绍新增人员的 API。

接口描述

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

接口地址

POST: /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	可进入周期段。
allowed_date	String	false	可进入时间段。
denied_date	String	false	不可进入时间段。

返回参数

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

result 说明

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

请求示例

POST: /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
}

错误码

参考错误码。

上一篇删除人员

下一篇更新人员