| 第1行： | 第1行： | ||
| − | {{ | + | {{api_desc_v2_sp| |
| + | host=http://rm.api.weibo.com/2/| | ||
uri=remind/unread_count| | uri=remind/unread_count| | ||
| − | desc= | + | desc=获取某个用户的各种消息未读数| |
httpMethod=GET| | httpMethod=GET| | ||
needAuth=是| | needAuth=是| | ||
level={{Api_L1}}| | level={{Api_L1}}| | ||
rateLimit=否| | rateLimit=否| | ||
| − | params={{api_args| | + | params= |
| − | {{api_args|callback|false|string| | + | {{api_args|uid|true|int64|需要获取消息未读数的用户UID。}} |
| + | {{api_args|callback|false|string|JSONP回调函数，用于前端调用返回JS格式的信息。}}| | ||
result= | result= | ||
<pre> | <pre> | ||
{ | { | ||
| − | " | + | "status": 0, |
| − | " | + | "follower": 1, |
| − | " | + | "cmt": 0, |
| − | " | + | "dm": 1, |
| − | " | + | "mention_status": 0, |
| − | " | + | "mention_cmt": 0, |
"group": 0, | "group": 0, | ||
| + | "private_group": 0, | ||
"notice": 0, | "notice": 0, | ||
"invite": 0, | "invite": 0, | ||
2011年11月28日 (一) 11:20的版本
remind/unread_count
获取某个用户的各种消息未读数
URL
http://rm.api.weibo.com/2/remind/unread_count.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：普通接口
频次限制：否
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| uid | true | int64 | 需要获取消息未读数的用户UID。 |
| callback | false | string | JSONP回调函数，用于前端调用返回JS格式的信息。 |
注意事项
无
返回结果
JSON示例
{
"status": 0,
"follower": 1,
"cmt": 0,
"dm": 1,
"mention_status": 0,
"mention_cmt": 0,
"group": 0,
"private_group": 0,
"notice": 0,
"invite": 0,
"badge": 0,
"photo": 0
}
关于错误返回值与错误代码，参见 错误代码说明
字段说明
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| status | int | 新微博未读数 |
| follower | int | 新粉丝数 |
| cmt | int | 新评论数 |
| dm | int | 新私信数 |
| mention_status | int | 新提及我的微博数 |
| mention_cmt | int | 新提及我的评论数 |
| group | int | 微群消息未读数 |
| private_group | int | 私有微群消息未读数 |
| notice | int | 新通知未读数 |
| invite | int | 新邀请未读数 |
| badge | int | 新勋章数 |
| photo | int | 相册消息未读数 |
| msgbox | int | {{{3}}} |
其他
无
