正向批量配置

使用场景:适用于企业微信机构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 当前机构配置结果错误信息
© 1998 - 2021 Tencent Inc. All Rights Reserved all right reserved,powered by ePaaS.更新时间: 2024-08-22 10:14:39

results matching ""

    No results matching ""

    results matching ""

      No results matching ""