正向批量配置
使用场景:适用于企业微信机构1:N映射教育号机构时,从零开始构建(即一个机构一个机构数据创建)的场景,或者不存在将一个机构数据拆分成多个机构的场景。
主要功能是将教育号侧新增机构挂到企业微信单一架构树中,同时创建和企业微信的各种映射关系,以便后续数据同步。
推荐使用的
1:N
配置方式注意事项:
- 该接口功能不涉及创建机构,需要配置的目标机构和上级机构都需要提前创建好
- 指定的上级机构需要已经映射到企业微信
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 需要 | |
用户凭证 | 支持 | 仅租户管理员 |
机构凭证 | 未支持 | - |
请求方式: POST(HTTPS)
请求地址:https://test-oapi.epaas.qq.com/corp/qywechat/mapping?access_token=ACCESS_TOKEN
{
"data_list": [
{
"corpid": 10000,
"superior_corpid": 10001
}
]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
data_list | 是 | 机构映射配置数据集 |
data_list.corpid | 是 | 机构id |
data_list.superior_corpid | 是 | 待关联的上级机构id |
备注:corpid是待关联到整棵架构树的机构;而superior_corpid是该机构挂靠的父节点;正向配置完成后corpid和superior_corpid自动成为上下级关系。
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"result_list": [
{
"corpid":10000,
"errcode": 0,
"errmsg": "ok"
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
result_list | 配置结果 |
result_list.corpid | 当前机构id |
result_list.errcode | 当前机构配置结果返回码 |
result_list.errmsg | 当前机构配置结果错误信息 |
反向批量配置
使用场景:适用于企业微信机构1:N映射教育号机构时,企业微信已存在数据且不可删除的场景。
主要用于反向批量配置教育号机构与企业微信部门映射;此时,会将企业微信反向同步的部门转换为教育号的机构。
不推荐使用的
1:N
配置方式,仅限特殊场景下,才使用反向配置注意事项:
(1)反向配置操作为不可逆操作,操作需谨慎
(2)进行反向配置前,请确认教育号和企业微信侧数据是否一致;不一致的场景下,不能调用该接口;否则,可能产生各种非预期结果,且不可逆(即无法恢复)。
(3)反向配置后的机构,将转变为纯正向同步机构;后续的数据同步都是正向同步(即教育号到企业微信),不再支持反向同步(即企业微信到教育号)
(4)此功能不包括创建机构,反向配置前,需要将企业微信侧反向同步到教育号的部门,所映射的机构提前创建好
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 需要 | |
用户凭证 | 支持 | 仅租户管理员 |
机构凭证 | 未支持 | - |
请求方式: POST(HTTPS)
请求地址:https://test-oapi.epaas.qq.com/corp/qywechat/mapping_reverse?access_token=ACCESS_TOKEN
{
"data_list": [
{
"corpid": 10000,
"department_id":30000,
"mapping_corpid": 10002
}
]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
data_list | 是 | 机构映射配置数据集 |
data_list.corpid | 是 | 机构id |
data_list.department_id | 是 | 部门id |
data_list.mapping_corpid | 是 | 部门id映射的机构id |
备注:department_id是要配置成独立机构的部门,corpid是该部门所在机构;而mapping_corpid是该部门独立之后所对应的机构;反向配置后mapping_corpid将作为corpid的下级机构挂靠到整棵架构树上。
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"result_list": [
{
"corpid":10002,
"errcode": 0,
"errmsg": "ok"
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
result_list | 配置结果 |
result_list.corpid | 当前机构id |
result_list.errcode | 当前机构配置结果返回码 |
result_list.errmsg | 当前机构配置结果错误信息 |