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

批量新增人员

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

本文介绍批量新增人员的 API。

接口描述

下发批量新增门禁人员指令给门禁，门禁设备端收到指令后批量新增门禁人员。

接口地址

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

请求参数

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

body 说明

参数名	类型	参数位置	是否必填	说明
person_list	List		true	批量新增人员对象

person_list 说明

参数名	类型	是否必填	说明
person_id	String	true	人员 ID
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	CmdIssueBatchResultResponse	返回结果

result 说明

参数名	类型	说明
sn_list	List	指令记录 ID

请求示例

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

{
  "person_list": [
    {
      "person_id": "123****",
      "begin_time": 1582959882104,
      "end_time": 1661666512292,
      "id_card": "330****",
      "name": "zhangsan",
      "phone": "135****",
      "person_floor": 5,
      "secret_key": "abc234****",
      "refresh_time": 300000
    },
    {
      "person_id": "123****",
      "begin_time": 1582959882104,
      "end_time": 1661666512292,
      "id_card": "330****",
      "name": "zhangsan",
      "phone": "135****",
      "person_floor": 5,
      "secret_key": "abc234****",
      "refresh_time": 300000
    }
  ]
}

返回示例

{
    "result": {
        "sn_list": [
            "133****",
            "132****"
        ]
    },
    "t": 1561456817168,
    "success": true
}

错误码

参考错误码。

上一篇门禁用户批量操作

下一篇批量新增二维码