新增人员

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

本文介绍新增人员的 API。

接口描述

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

接口地址

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

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue涂鸦设备 ID
person_idStringuritrue人员 ID

body 说明

参数名类型参数位置是否必填说明
nameString false人员姓名
id_cardString false证件 ID
phoneString false手机号
begin_timeLong true有效期开始时间
end_timeLong true有效期结束时间
floor_auth_listList false授权楼层列表
secret_keyString false人员密钥 固定长度32位
refresh_timeLong false二维码刷新时间,单位毫秒

返回参数

参数名类型说明
resultCmdIssueResultResponse响应结果

result 说明

参数名类型说明
snString指令记录 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
}

错误码

参考 错误码