获取消息列表 - listMessages
功能介绍
获取当前用户的消息列表
授权信息
当前API调用无需身份策略权限。
URI
GET /koodrive/ose/v1/message/list
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
pageSize | 否 | Integer | 每页返回的个数,默认是100,可接受值最大值是100。注意在到达最后的列表之前,实际有可能返回部分或者空结果 |
pageCursor | 否 | String | 当前页游标,由前一个响应的nextCursor获取,默认为0 |
filterType | 否 | String | 过滤类型。 000:分享消息; 001:团队消息; 002:系统消息; 003:管理消息 |
state | 否 | Integer | 消息状态。0:未读;1:已读 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Authorization | 是 | String | 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} |
language | 否 | String | 国际化语言标识,符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语,不传默认美式英语 |
X-User-Id | 是 | String | 用户id,用于app鉴权 |
X-Date | 是 | String | 日期,用于app鉴权 |
Host | 是 | String | 地址,用于app鉴权 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
code | String | 响应码 |
msg | String | 响应信息 |
nextCursor | String | 分页游标,如果不存在,代表已返回最后一个 |
messages | MessageInfo object | 消息对象 |
请求示例
无
响应示例
无
状态码
状态码 | 描述 |
|---|---|
200 | 获取消息列表响应体。 |

