獲取已讀未讀消息列表接口
云通訊平臺(tái)為開發(fā)者提供了獲取已讀未讀消息列表接口，該接口主要用于獲取群組已讀未讀消息，需要結(jié)合客戶端設(shè)置消息已讀接口使用。
1、請(qǐng)求地址
/{SoftVersion}/Application/{appId}/IMPlus/MessageReceipt
2、請(qǐng)求包頭
請(qǐng)參閱《鑒權(quán)說明》
3、請(qǐng)求包體
| 屬性 | 類型 | 約束 | 說明 |
|---|---|---|---|
| msgId | String | 可選 | 消息Id，客戶端發(fā)消息返回的消息id。version和msgId兩個(gè)參數(shù)二選一，都傳則以version為準(zhǔn)。 |
| version | String | 可選 | 消息版本號(hào) | pageSize | int | 可選 | 數(shù)量默認(rèn)50條，最大100條，超過100條返回錯(cuò)誤碼 | pageNo | int | 可選 | 頁碼 默認(rèn)第一頁 | type | int | 必選 | 類型 1.已讀 2.未讀 |
| userName | String | 必選 | 用戶賬號(hào) |
3.1、請(qǐng)求示例
POST:/2013-12-26/Application/20150314000000110000000000000010/IM/MessageReceipt?sig=b1491f1dc4e2b3ea9611d129427d17c8 HTTP/1.1
content-type: application/json;charset=utf-8
accept: application/json
authorization:MjAxNTAzMTQwMDAwMDAxMTAwMDAwMDAwMDAwMDAwMTA6MjAxNjA4MTkxNzUyNDM=
content-length: 79
host: 127.0.0.1:8080
connection: Keep-Alive
{
"msgId":"111",
"version":"12",
"pageSize":2,
"pageNo":3,
"type":1,
"userName":"123"
}
4、響應(yīng)包體
| 屬性 | 類型 | 約束 | 說明 |
|---|---|---|---|
| statusCode | String | 必選 | 請(qǐng)求狀態(tài)碼，取值200（成功）。 |
| result | List | 必選 | 返回結(jié)果集 |
| useracc | String | 可選 | 用戶信息 |
| time | String | 可選 | 時(shí)間 |
| totalSize | String | 必選 | 總頁數(shù) |
4.1、響應(yīng)示例
HTTP/1.1 200 OK
Content-Length: 641
{
"statusCode":"200",
"result":[
{"useracc":"aa#333", "time":"1470213301751"},
{"useracc":"aa#444", "time":"1470213301751"}
],
"totalSize":"3"
}