上下游系统应用可通过该接口新增一条对接规则。
注意:新增和更新上下游对接规则的接口每天最多调用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 |