读取门禁通行规则

POST

https://qyapi.weixin.qq.com/cgi-bin/devicedata/get_accesscontrol_rule

第三方应用获取企业已设置的门禁规则。

注意：
1.第三方应用须具有“设备接口信息权限-读取门禁规则”授权；
2.企业须同时安装硬件设备和第三方应用；
3.仅返回第三方应用可见范围内的成员对应设备的门禁规则数据；

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/devicedata/get_accesscontrol_rule' \
--header 'Content-Type: application/json' \
--data-raw '{
	"device_sn":"SN"
}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "pass_rule": {
    "items": [
      {
        "rule_id": "xxx",
        "name": "rule_name",
        "rule_list": [
          "9:00-10:00 * * 1-5 *",
          "16:00-19:05 * * 6 *",
          "20:00-21:30 * * 0 *"
        ],
        "effect_time": 1542874137,
        "effect_open_userid_list": [
          {
            "open_userid": "user1",
            "user_type": 0
          },
          {
            "open_userid": "user2",
            "user_type": 2
          }
        ]
      },
      {
        "rule_id": "xxq",
        "rule_list": [
          "9:300-10:00 * * 6 *"
        ],
        "effect_time": 1542874137,
        "effect_open_userid_list": [
          "user1",
          "user2"
        ]
      }
    ]
  },
  "remote_pass_rule": {
    "items": [
      {
        "rule_id": "xxx",
        "name": "rule_name",
        "rule_list": [
          "9:00-10:00 * * 1-5 *",
          "11:00-12:00 * * 6,0 *"
        ],
        "effect_time": 1542874137,
        "effect_open_userid_list": [
          {
            "open_userid": "user1",
            "user_type": 0
          },
          {
            "open_userid": "user2",
            "user_type": 2
          }
        ]
      },
      {
        "rule_id": "xxq",
        "rule_list": [
          "9:300-10:00 * * 6 *"
        ],
        "effect_time": 1542874137,
        "effect_open_userid_list": [
          {
            "open_userid": "user1",
            "user_type": 0
          },
          {
            "open_userid": "user2",
            "user_type": 2
          }
        ]
      }
    ]
  }
}

请求参数

Query 参数

access_token

string

应用调用接口权限

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

device_sn

string

打卡设备SN

必需

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误码描述

必需

pass_rule

object

门禁规则列表

必需

items

array [object {5}]

必需

remote_pass_rule

object

必需

远程开门规则列表，object内各字段含义与 pass_rule_list相同

items

array [object {5}]

必需

修改于 2022-12-08 02:36:05

获取门禁通行原始数据

写入门禁通行规则