【導讀】集成接口技術白皮書。網(wǎng)址：熱線：400-6281-163第I頁。穩(wěn)定可靠，安全無憂

　　

【正文】 //獲取條數(shù)，每次最多 100 條 returnTotal:true //是否返回 郵件 總數(shù) } product 企業(yè)標識 必填 匹配項 服務接口可能返回的通用錯誤碼 :IP 被禁止 :其他錯誤 :參數(shù)不能為空 :參數(shù)不合法 :簽名錯誤 :沒有權 限訪問此接口 :產(chǎn)品號為空 :訪問過于頻繁 :訪問時間超出限制 集成接口技術白皮書 網(wǎng)址： 熱線： 4006281163 第 21 頁 URL 示例 注意： 紅色字體 為需要 簽名 內(nèi)容 (priKey, src)。 1. 獲取所有部門列表 me=1418558015552amp。sign=domain=amp。product=abc_amp。time=1418558015552 成功結(jié)果： { 39。con39。: [ { 39。unit_desc39。: 39。正式部門 39。, 39。unit_id39。: 39。33501739。, 39。unit_name39。: 39。正式部門 39。 }, { 39。unit_id39。: 39。33502039。, 39。unit_name39。: 39。test39。 } ], 39。suc39。: true, 39。ver39。: 1418554605599 } 失敗結(jié)果： {error_code:,suc:false,ver:0} 2. 獲取帳號別名 domain=amp。product=abc_amp。time=1418559066063amp。sign=account_name=zhangsanamp。domain=amp。product=abc_amp。time=1418559066063 成功結(jié)果： { 39。con39。: [ 39。zs00139。, 39。zs39。 ], 39。suc39。: true, 39。ver39。: 1418558906403 } 失敗結(jié)果： {error_code:,suc:false,ver:0} 3. 獲取綁定手機號碼 集成接口技術白皮書 網(wǎng)址： 熱線： 4006281163 第 22 頁 amp。product=abc_amp。time=1418559871893amp。time=1418559871893amp。sign=account_name=zhangsanamp。domain=amp。product=abc_ 成功結(jié)果： { 39。con39。: { 39。account_name39。: 39。zhangsan39。, 39。domain39。: 39。39。, 39。mobile39。: 39。1361231231239。 }, 39。suc39。: true, 39。ver39。: 0 } 失敗結(jié)果： {error_code:,suc:false,ver:0} 4. 查詢收信記錄 amp。params=%7B%22fids%22%3A%5B1%2C5%5D%2C%22order%22%3A%22receivedDate%22%2C%22desc%22%3Atrue%2C%22start%22%3A0%2C%22limit%22%3A5%2C%22returnTotal%22%3Atrue%7Damp。product=abc_amp。sign=account_name=zhangsanamp。domain=amp。params={fids:[1,5],order:receivedDate,desc:true,start:0,limit:5,returnTotal:true}amp。product=abc_amp。time=1421912830803 成功結(jié)果： { 39。con39。: { 39。total39。: 2,//郵件總數(shù)量 39。var39。: [ { 39。antiVirusStatus39。: 39。NOT_VIRUS39。, 39。backgroundColor39。: 0, 39。fid39。: 1, 39。flags39。: { }, 39。from39。: 39。admin 39。, //發(fā)件人 39。id39。: 39。AMEAmwDkAOQHRfNlzkVQfqpa39。, //郵件標識 39。label039。: 0, 39。modifiedDate39。: 1418745600000, 39。priority39。: 3, 39。receivedDate39。: 1418745600000, //接收時間 39。sentDate39。: 1418745600000, 39。size39。: 1935, 39。subject39。: 39。測試 39。, //郵件主題 39。threadMessageCount39。: 0, 集成接口技術白皮書 網(wǎng)址： 熱線： 4006281163 第 23 頁 39。to39。: 39。產(chǎn)品 ,行政 39。//收件人 }, { 39。antiVirusStatus39。: 39。NOT_VIRUS39。, 39。backgroundColor39。: 0, 39。fid39。: 1, 39。flags39。: { 39。attached39。: true, 39。read39。: true,//已讀標記 39。realAttached39。: true }, 39。from39。: 39。校園郵箱郵箱系統(tǒng)管理員 39。, 39。id39。: 39。APUAegDrAOYGeHQEdN784oL39。, 39。label039。: 0, 39。modifiedDate39。: 1421683202000, 39。priority39。: 3, 39。receivedDate39。: 1415030400000, 39。sentDate39。: 1415030400000, 39。size39。: 13184, 39。subject39。: 39。歡迎您使用校園郵箱郵箱！ 39。, 39。threadMessageCount39。: 0, 39。to39。: 39。zhangsan 39。 } ] }, 39。suc39。: true, 39。ver39。: 0 } 失敗結(jié)果： {error_code:,suc:false,ver:0} 集成接口技術白皮書 網(wǎng)址： 熱線： 4006281163 第 24 頁 5 未讀郵件數(shù)量接口 接口說明 采用 RSA 加密算法的 HTTPS 協(xié)議接口，客戶提交加密的郵箱帳號和服務器時間信息，網(wǎng)易企業(yè)郵箱驗證并解密參數(shù)后，返回對應郵箱帳號所有未讀郵件的數(shù)量。 接口規(guī)范 技術規(guī)范 1. 客戶按網(wǎng)易企業(yè)郵箱提供的算法（標準 RSA 算法， 1024 位密鑰長度）生成公私鑰，將公鑰提供給網(wǎng)易企業(yè)郵箱，私鑰自行妥善保管，通過接口提交URL 鏈接參數(shù)必須使用 RSA 私鑰加密，禁止明文傳輸。 2. 客戶還 需要提供訪問接口的服務器 IP 地址。網(wǎng)易企業(yè)郵箱會對 IP 地址進行服務授權，進一步增強接口的安全性，確保用戶數(shù)據(jù)傳輸?shù)慕^對保密性 3. 接口使用 HTTPS 協(xié)議，每個請求 URL 只有一次請求有效，每個 URL 生成后半小時之內(nèi)有效。 使用規(guī)范 1. 用 GET 或者 POST 請求到 URL： ain=*amp。format=*amp。sign=*amp。time=*amp。type=* 2. *：真實 URL 中替換為實際操作要填入的 參數(shù) 值 。 3. domain：企業(yè)郵箱注冊域名，用于標識客戶。 4. account_name： 用戶帳號，不帶域名后綴。 5. type：郵箱文件夾類型。 1收件箱， 2草稿箱， 3已發(fā)送， 4已刪除， 5垃圾郵件， 6病毒文件夾，如需查詢多種類型請用逗號分隔，默認 type=1,5 6. time：時間戳， 即當前時間距離 19700101的時間間隔，單位為 ms。 7. format：返回結(jié)果格式，支持 json、 xml、 text 三種格式，默認返回 json。 8. sign： RSA 加密內(nèi)容，參數(shù) 名 按 字母順序進行排列，每個參數(shù)后面帶上等號和參數(shù)值，參 數(shù)之間用 amp。連接 ，加密明文如： 集成接口技術白皮書 網(wǎng)址： 熱線： 4006281163 第 25 頁 account_name=*amp。domain=*amp。format=*amp。time=*amp。type=* 9. 返回數(shù)據(jù)包含的屬性有 : status（成功 1，失敗 0） msg（結(jié)果描述） count（未讀郵件數(shù)）。 數(shù)據(jù)格式將根據(jù)請求時的 format 參數(shù)指定，如果沒有傳此參數(shù)默認返回json 格式， 示例如下所述： 應用示例 1. GET 方式提交的 URL 為： namp。domain=amp。time=1418561220735amp。sign=85a5f09657e0a57abfa5de43597ef5c825bc8c456e4aae2286697005a75702f2282abfb9142dae63327cde2cb9dff2dea8a4de9905ec716aa5ed22b89959378f05f1ec20e60f1352e92020d02cf6ac8e69f89a3846ca3d2125f94b14796e613c28540a849b67ee1a1d54a86883a4b2922557681f4df6021fa5e1b78a28488ab3 a) 企業(yè)域名是 ，所以 domain= b) 要求查詢 zhangsan 帳號的未讀郵件，所以 sign 的明文是： 成功： { “status”:1, “msg”:” information”, “count”:5 } 失?。?{ “status”:0, “msg”:” information”, “count”:0 } 集成接口技術白皮書 網(wǎng)址： 熱線： 4006281163 第 26 頁 account_name=zhangsanamp。domain=amp。time=1418561220735 c) 經(jīng)過 RSA 加密后，上述明文對應的 sign 密文是： 85a5f09657e0a57abfa5de43597ef5c825bc8c456e4aae2286697005a75702f2282abfb9142dae63327cde2cb9dff2dea8a4de9905ec716aa5ed22b89959378f05f1ec20e60f1352e92020d02cf6ac8e69f89a3846ca3d2125f94b14796e613c28540a849b67ee1a1d54a86883a4b2922557681f4df6021fa5e1b78a28488ab3 2. 操作成功， zhangsan 未讀郵件數(shù)量是 3，所以返回結(jié)果是： {count:3,status:OK} 集成接口技術白皮書 網(wǎng)址： 熱線： 4006281163 第 27 頁 6 單點登錄 接口 接口說明 采用 RSA 加密算法的 HTTP 協(xié)議接口，客戶提交郵箱帳號及加密信息，網(wǎng)易企業(yè)郵箱解密驗證通過后，給予瀏覽器頁面自動跳轉(zhuǎn)登錄訪問郵箱。