所有接口與IMAP同步,需要使用utf8編碼來解析json
>[info]獲取新郵件數據
使用該接口可獲取及時郵件數量與未讀郵件、新郵件
~~~[api]
post:/Api/MailImap/getNewMessage
*email#郵箱地址
int:uidNext=默認0#下一個郵件uid,提供該uid才會判斷是否有新的郵件,可從返回的數據參數獲取
<<<
success
"data":
{
"count":返回收件箱總數,包含已讀與未讀的郵件,
"unseenCount":返回未讀郵件數量
"uidNext":下一個郵件uid,每次獲取都是最新的uid,未錄入數據的uid
"newMessage":新郵件數據,如沒新郵件,該參數是空數組
}
<<<
error
{
"msg": '提示字符串'
}
~~~
**使用方法:**
網站應用可使用ajax來循環獲取該接口來判斷,建議30秒循環一次。
在post中提供了uidNext參數才會判斷是否有新郵件來,因為是跟imap同步的,所以第一次可不提供,不判斷新郵件。
newMessage參數詳解:
當有新郵件來,該參數才會有數據
~~~
"newMessage":
{
"list":[{ //該參數是一個數組,如果是多個新郵件,就會有多條數據
"uid":郵件uid,
"subject":郵件標題,
"from":發件人郵箱
"from_name":發件人名稱
"time":發件時間,unix時間戳
}],
"topUid":最新的郵件uid,list中有該uid的數據
}
~~~
如需要獲取郵件內容,請使用下面接口,可根據uid獲取
>[info]獲取單個郵件的詳細數據
~~~[api]
post:/Api/MailImap/getMessage
*email#郵箱地址
*int:uid#郵件uid
<<<
success
"data":
{
"subject":郵件標題,
"from":發件人郵箱,
"from_name":發件人名稱,發件人如果沒填寫名稱,那么該參數就是空的,
"to":收件人,這是一個數組,可能包含多個收件人
"seen":該郵件是否已讀,true已讀,false未讀,
"content":郵件內容,該參數會有html代碼的,可根據情況是否過濾,
"time":郵件創建時間
}
<<<
error
{
"msg": '提示字符串'
}
~~~
>[info]獲取郵件列表(暫未啟用)
~~~[api]
post:/Api/MailImap/getListMessage
*email#郵箱地址
*int:offset#設定第幾條數據開始
*int:limit#設定獲取的總條數
<<<
success
"data":
{
"count":全部郵件總數,
"unseenCount":未讀郵件總數,
"list":這是一個數組,包含郵件詳細的數據,參數可參考getMessage接口
}
<<<
error
{
"msg": '提示字符串'
}
~~~
>[info]設置郵件已讀狀態(暫未啟用)
~~~[api]
post:/Api/MailImap/setMessageSeen
*email#郵箱地址
*int:uid#郵件uid
<<<
success
"data":
{
true
}
<<<
error
{
"msg": '提示字符串'
}
~~~
更多郵件操作接口,以后繼續開放,請敬請關注!