主动调用
主动调用是最基本的连接模式,当你的应用调用企业邮时,需使用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"
}