主动调用

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