读取门禁通行规则

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

获取门禁通行原始数据

写入门禁通行规则