修改门禁通行规则

第三方应用可修改企业已经存在的门禁规则。

注意：
1.第三方应用须具有“设备接口信息权限-创建门禁规则”授权；
2.企业须同时安装硬件设备和第三方应用；
3.修改规则成员仅能包含第三方应用可见范围内成员与授权设备设备可见范围内成员的交集成员；
4.如果已经存在的规则包含了第三条交集成员外的成员，则app无法通过此api进行修改
5.如果已经存在的规则包含了app授权设备列表范围外的设备，则app无法通过此api进行修改
6.第三方应用只能更改自己创建的门禁规则

pass_rule目前仅仅时分字段和星期字段配置，即第一和第四个字段（共5个字段）
9:00-10:00 * * 1-5 *, 会被解析成每周一到周五上午9点整至10点整，其余星号被替换成其他内容暂不生效
9:00-10:00,15:30-17:45 * * 0,6 *, 会被解析成每周六周日上午 9点整至10点整以及下午15:30至17:45，其余星号被替换成其他内容暂不生效
pass_rule暂不支持 / 操作符

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/devicedata/mod_accesscontrol_rule' \ --header 'Content-Type: application/json' \ --data-raw '{ "rule_id":"xxx", "device_sn_list":["SN"], "rule_name":"access_rule_name_xxx", "pass_rule":{ "rule_list":[ "9:00-10:00 * * 1-5 *", "9:00-10:00,15:30-17:45 * * 0,6 *" ], "effect_open_userid_list":[ { "open_userid":"user1", "user_type":0 }, { "open_userid":"user2", "user_type":2 } ] }, "remote_pass_rule":{ "rule_list":[ "9:00-10:00 * * 1-5 *", "9:00-10:00,15:30-17:45 * * 0,6 *" ], "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

rule_id

string

必需

企业微信返回的rule_id，门禁规则的标识id

device_sn_list

array[string]

设备SN列表

必需

rule_name

string

门禁规则名称

必需

pass_rule

object

门禁规则

可选

rule_list

array[string]

必需

rule为具体规则，其解析语法请参考附录门禁放行规则语法说明

effect_open_userid_list

array [object {2}]

必需

生效成员的openuserid列表

remote_pass_rule

object

必需

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

rule_list

array[string]

必需

effect_open_userid_list

array [object {2}]

必需

示例

application/json

Body

errcode

integer

必需

errmsg

string

必需

invalid_list

array[string]

必需

非法的open_userid列表，errcode不为0时此字段有效

请求参数

返回响应