企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
通讯录管理
通讯录查看权限管理
读取规则列表
读取规则列表
最后更新:2026/06/04

读取规则列表

该接口用于一次性读取指定类型的通讯录隐藏规则列表

请求方式: POST(HTTPS

请求地址: https://qyapi.weixin.qq.com/cgi-bin/contactrule/list?access_token=ACCESS_TOKEN

 

参数说明:

参数是否必须说明
access_token调用接口凭证。仅通讯录同步应用的 access_token 可调用该接口

权限说明:

  • 仅允许通讯录同步应用调用。

返回结果:

{
  "errcode": 0,
  "errmsg": "ok",
  "rules": [
    {
      "rule_id": 10001,
      "rule_type": 1,
      "range": {
        "userid": ["zhangsan", "lisi"],
        "partyid": [1, 2],
        "tagid": [3]
      },
      "whitelist": {
        "userid": ["wangwu"],
        "partyid": [4],
        "tagid": []
      }
    }
  ]
}

返回参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
rules通讯录隐藏规则列表
rules.rule_id规则唯一标识
rules.rule_type规则类型。
1 - 隐藏部门/成员
2 - 限制查看外部门
3 - 限制查看所有人
rules.range规则目标范围,被隐藏或受限的部门、成员、标签
rules.range.userid成员 ID 列表
rules.range.partyid部门 ID 列表
rules.range.tagid标签 ID 列表
rules.whitelist白名单范围,允许查看的部门、成员、标签
rules.exclude排除名单范围,不受该规则限制的部门、成员、标签
rules.is_allowed_search是否允许搜索
rules.is_allowed_conversation是否允许会话
上一篇创建规则
下一篇修改规则
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
消息推送(原“群机器人”)
更新日志
联系我们