异步批量接口用于大批量数据的处理,提交后接口即返回,企业微信会在后台继续执行任务。
执行完成后,企业微信后台会通过任务事件通知企业获取结果。事件的内容是加密的,解密过程请参考 [消息的加解密处理][signure],任务事件请参考异步任务完成事件推送。
目前,仅为通讯录更新提供了异步批量接口
通讯录更新接口提供三种更新方法:1) 增量更新成员 2)全量覆盖成员 3) 全量覆盖部门。后面具体描述更新逻辑。
如果企业要做到与企业微信通讯录完全一致,可先调用全量覆盖部门接口,再调用全量覆盖成员接口,即可保持通讯录完全一致。
使用步骤:
1.下载接口对应的csv模板,如果有扩展属性,请自行添加(扩展属性需要在WEB管理端创建后才生效,否则忽略未知属性的赋值。见创建扩展属性)
2.按模板的格式,生成接口所需的数据文件(必须保持为utf-8格式)
3.通过上传媒体文件接口上传数据文件,获取media_id
4.调用通讯录更新接口,传入media_id参数
5.接收任务完成事件,并获取任务执行结果