企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
上下游
上下游规则
新增对接规则
新增对接规则
最后更新:2023/12/07

上下游系统应用可通过该接口新增一条对接规则。
注意:新增和更新上下游对接规则的接口每天最多调用1000次

请求方式: POST( HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/corpgroup/rule/add_rule?access_token=ACCESS_TOKEN

请求示例:

{
   "chain_id":"Chxxxxxx",
   "rule_info": {
      "owner_corp_range": {
         "departmentids": ["departmentid1", "departmentid2"],
         "userids": ["userid1","userid2"]
      },
      "member_corp_range": {
         "groupids": ["groupid1", "groupid2"],
         "corpids": ["corpid1","corpid2"]
      }
   }
}

参数说明:

参数必须说明
access_token调用接口凭证
chain_id上下游id
rule_info上下游关系规则的详情
rule_info.owner_corp_range上游企业的对接人规则(下游企业可以看到并联系的成员或部门)
rule_info.owner_corp_range.departmentids部门id,部门id和用户id两个必选填一个
rule_info.owner_corp_range.userids用户id,部门id和用户id两个必选填一个
rule_info.member_corp_range下游企业规则范围
rule_info.member_corp_range.groupids分组id,分组id和企业id两个必选填一个
rule_info.member_corp_range.corpids企业id,分组id和企业id两个必选填一个

权限说明:

调用的应用需要满足如下的权限,仅适用于上下游中创建空间的主企业调用。操作的规则对应的企业用户和部门都需要在应用的可见范围内。

应用类型权限要求
自建应用配置到「上下游- 可调用接口的应用」中

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "rule_id": 1
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
rule_id上下游规则id
上一篇获取对接规则详情
下一篇更新对接规则
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们