企业通讯录安全特别重要,企业微信将持续升级加固通讯录接口的安全机制,以下是关键的变更点:
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/export/simple_user?access_token=ACCESS_TOKEN
请求示例:
{
"encoding_aeskey": "IJUiXNpvGbODwKEBSEsAeOAPAhkqHqNCF6g19t9wfg2",
"block_size": 1000000
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
encoding_aeskey | 是 | Base64编码后的加密密钥。长度固定为43,从a-z, A-Z, 0-9共62个字符中选取,是AESKey的Base64编码。解码后即为32字节长的AESKey。加密方式采用AES-256-CBC方式,数据采用PKCS#7填充至32字节的倍数;IV初始向量大小为16字节,取AESKey前16字节,详见:https://datatracker.ietf.org/doc/html/rfc2315 |
block_size | 否 | 每块数据的人员数,支持范围[104,106],默认值为106 |
AESKey=Base64_Decode(encoding_aeskey + “=”)
权限说明:
仅会返回有权限的人员列表
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"jobid": "jobid_xxxxxxxxx"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
jobid | 任务ID,可通过获取导出结果接口查询任务结果 |