開始開發(fā)
通訊錄管理
管理部門
管理成員
管理郵件群組
功能設置
系統(tǒng)日志
新郵件提醒
單點登錄
附錄
加解密方案的詳細說明
加解密庫下載與返回碼
主動調(diào)用
主動調(diào)用是最基本的連接模式,當你的應用調(diào)用企業(yè)郵時,需 使用HTTPS協(xié)議、Json數(shù)據(jù)格式、UTF8編碼,訪問域名為https://api.exmail.qq.com,數(shù)據(jù)包不需要加密。
在每次主動調(diào)用企業(yè)郵接口時需要帶上AccessToken參數(shù)。AccessToken參數(shù)由CorpID和CorpSecret換取。
CorpID是企業(yè)郵的標識,每個企業(yè)郵擁有一個唯一的CorpID;
當企業(yè)應用調(diào)用企業(yè)郵接口時,企業(yè)郵后臺根據(jù)此次訪問的AccessToken,校驗訪問的合法性。
基礎(chǔ)頻率
每企業(yè)調(diào)用單個cgi/api不可超過500次/分,15000次/小時
企業(yè)每ip調(diào)用接口不可超過10000次/分,300000次/小時
獲取ACCESS_TOKEN
HTTPS請求方式: GET
請求地址: https://api.exmail.qq.com/cgi-bin/gettoken?corpid=id&corpsecret=secrect
- 參數(shù)說明
參數(shù) | 必須 | 說明 |
---|---|---|
corpid | 是 | 企業(yè)id |
corpsecret | 是 | 應用的憑證密鑰 |
- 權(quán)限說明
每個應用有不同的secret,代表了對應用的不同權(quán)限
- 返回結(jié)果
{ "access_token": "accesstoken000001", "expires_in": 7200 }
參數(shù) | 說明 |
---|---|
access_token | 獲取到的憑證。長度為64至512個字節(jié) |
expires_in | 憑證的有效時間(秒) |
- 出錯返回示例
{ "errcode": 40001, "errmsg": "invalid credential" }