主动调用
主动调用是最基本的连接模式,当你的应用调用企业邮时,需使用HTTPS协议、Json数据格式、UTF8编码,访问域名为https://api.exmail.qq.com,数据包不需要加密。
在每次主动调用企业邮接口时需要带上AccessToken参数。AccessToken参数由CorpID和CorpSecret换取。
CorpID是企业邮的标识,每个企业邮拥有一个唯一的CorpID;
当企业应用调用企业邮接口时,企业邮后台根据此次访问的AccessToken,校验访问的合法性。
基础频率
每企业调用单个cgi/api不可超过500次/分,15000次/小时
企业每ip调用接口不可超过10000次/分,300000次/小时
获取ACCESS_TOKEN
HTTPS请求方式: GET
请求地址: https://api.exmail.qq.com/cgi-bin/gettoken?corpid=id&corpsecret=secrect
参数说明
参数 | 必须 | 说明 |
---|---|---|
corpid | 是 | 企业id |
corpsecret | 是 | 应用的凭证密钥 |
权限说明
每个应用有不同的secret,代表了对应用的不同权限
返回结果
{ "access_token": "accesstoken000001", "expires_in": 7200 }
参数 | 说明 |
---|---|
access_token | 获取到的凭证。长度为64至512个字节 |
expires_in | 凭证的有效时间(秒) |
出错返回示例
{ "errcode": 40001, "errmsg": "invalid credential" }