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

新增人员

更新时间：2023-06-20 14:54:11

本文介绍新增人员的 API。

接口描述

下发新增梯控人员指令给梯控，梯控设备端收到指令后新增该人员。

接口地址

POST: /v1.0/elevator-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	手机号
begin_time	Long	true	有效期开始时间
end_time	Long	true	有效期结束时间
floor_auth_list	List	false	授权楼层列表
secret_key	String	false	人员密钥固定长度32位
refresh_time	Long	false	二维码刷新时间,单位毫秒

返回参数

参数名	类型	说明
result	CmdIssueResultResponse	响应结果

result 说明

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

请求示例

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

{
  "begin_time": 1582959882104,
  "end_time": 1661666512292,
  "id_card": "330****",
  "name": "张三",
  "phone": "135****",
  "floor_auth_list": [
    1,
    2,
    3
  ],
  "secret_key": "abc123***",
  "refresh_time": 300000
}

返回示例

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

错误码

参考错误码。

上一篇更新人员

下一篇梯控人脸管理