第三方应用开发 服务端API 通讯录管理 异步批量接口 全量覆盖部门
全量覆盖部门

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

注意事项:

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

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/batch/replaceparty?access_token=ACCESS_TOKEN

请求包体:

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

参数说明 :

参数必须说明
media_id上传的csv文件的media_id
callback回调信息。如填写该项则任务完成后,通过callback推送事件给企业。具体请参考应用回调模式中的相应选项
url企业应用接收企业微信推送请求的访问协议和地址,支持http或https协议
token用于生成签名
encodingaeskey用于消息体的加密,是AES密钥的Base64编码

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

返回结果:

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

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
jobid异步任务id,最大长度为64字节
上一篇
全量覆盖成员
下一篇
获取异步任务结果