新增门禁规则

更新时间:2023-06-21 07:13:01

本文介绍新增门禁规则的 API。

接口描述

新增门禁规则,包含名称、通行时间等基础信息。

接口地址

POST: /v1.0/iot-02/access-controls

请求参数

body 说明

参数名类型参数位置是否必填说明
access_control_nameString true门禁名称,最长可设 128 位
user_limitBoolean false是否限制用户的门禁权限。
  • false:表示不做限制,全员都有权限。
  • true:表示做了限制,需要指定授权部分用户拥有门禁权限。
    time_limitBoolean false是否时间限制。默认值为 false。
    • false:表示全天可通行
    • true:表示存在通行时间限制,需要填写 time_ranges 作为通行时间段
    time_rangesList false通行时间段,最多可设置 5 个

    返回参数

    参数名类型说明
    resultString门禁规则 ID

    请求示例

    POST: /v1.0/iot-02/access-controls
    
    {
      "access_control_name": "门禁规则",
      "time_limit": true,
      "user_limit": true,
      "time_ranges": [
        "06:00-9:00",
        "10:00-19:00",
        "10:00-19:00",
        "10:00-19:00"
      ]
    }
    

    返回示例

    {
        "result": "146304353014959****",
        "t": 1637651734297,
        "success": true
    }
    

    错误码

    参考 错误码