全量覆盖部门

POST

/cgi-bin/batch/replaceparty

本接口以partyid为键，全量覆盖企业的通讯录组织架构，任务完成后企业的通讯录组织架构与提交的文件完全保持一致。请先下载CSV文件(下载全量覆盖部门模版)，根据需求填写文件内容。

注意事项：

文件中存在、通讯录中也存在的部门，执行修改操作
文件中存在、通讯录中不存在的部门，执行添加操作
文件中不存在、通讯录中存在的部门，当部门下没有任何成员或子部门时，执行删除操作
文件中不存在、通讯录中存在的部门，当部门下仍有成员或子部门时，暂时不会删除，当下次导入成员把人从部门移出后自动删除
CSV文件中，部门名称、部门ID、父部门ID为必填字段，部门ID必须为数字，根部门的部门id默认为1；排序为可选字段，置空或填0不修改排序, order值大的排序靠前。

权限说明：
须拥有通讯录的写权限。

文档ID: 15016
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90982
https://open.work.weixin.qq.com/api/doc/90001/90143/91132
https://open.work.weixin.qq.com/api/doc/90002/90151/91165

请求参数

Query 参数

Body 参数application/json

示例

{"media_id":"xxxxxx","callback":{"url":"xxx","token":"xxx","encodingaeskey":"xxx"}}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/cgi-bin/batch/replaceparty?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{"media_id":"xxxxxx","callback":{"url":"xxx","token":"xxx","encodingaeskey":"xxx"}}'

返回响应

🟢200成功

application/json

Body

示例

{"errcode":0,"errmsg":"ok","jobid":"xxxxx"}

修改于 2025-03-26 09:11:31

全量覆盖成员

获取异步任务结果