開始開發
通訊錄管理
管理部門
管理成員
管理郵件群組
功能設置
系統日志
新郵件提醒
單點登錄
附錄
加解密方案的詳細說明
加解密庫下載與返回碼
主動調用
主動調用是最基本的連接模式,當你的應用調用企業郵時,需 使用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" }