所有接口与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": '提示字符串'
}
~~~
更多邮件操作接口,以后继续开放,请敬请关注!