全量覆盖部门

本接口以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 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

media_id

string

必需

上传的csv文件的media_id

callback

object

可选

回调信息。如填写该项则任务完成后，通过callback推送事件给企业。具体请参考应用回调模式中的相应选项

url

string

可选

企业应用接收企业微信推送请求的访问协议和地址，支持http或https协议

token

string

用于生成签名

可选

encodingaeskey

string

可选

用于消息体的加密，是AES密钥的Base64编码

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

errcode

integer <int32>

返回码

可选

jobid

string

可选

异步任务id，最大长度为64字节

errmsg

string

可选

对返回码的文本描述内容

示例

{
  "errcode": 0,
  "jobid": "string",
  "errmsg": "string"
}

请求参数

示例代码

返回响应