Statuses/unread
(→返回结果) |
|||
(未显示3个用户的17个中间版本) | |||
第1行: | 第1行: | ||
− | + | {{api_desc2| | |
− | + | uri=statuses/unread | | |
− | + | desc=获取当前用户[http://t.sina.com.cn Web主站]未读消息数,包括: | |
− | = | + | * 是否有新微博消息 |
− | http:// | + | * 最新提到“我”的微博消息数 |
− | + | * 新评论数 | |
− | + | * 新私信数 | |
− | + | * 新粉丝数。<br/> | |
− | + | 此接口对应的清零接口为[[statuses/reset_count]]。| | |
− | = | + | format=XML/JSON| |
− | GET | + | httpMethod=GET| |
− | + | needAuth=true| | |
− | == | + | rateLimit=true| |
− | + | params={{api_args|with_new_status|false|int,默认为0。|1表示结果中包含new_status字段,0表示结果不包含new_status字段。new_status字段表示是否有新微博消息,1表示有,0表示没有}} | |
− | + | {{api_args|since_id|false|int64|参数值为微博id。该参数需配合with_new_status参数使用,返回since_id之后,是否有新微博消息产生}}| | |
− | === | + | getParam=&with_new_status=1&since_id=300000000| |
− | + | postParam=| | |
− | + | result= | |
− | === | + | ===XML示例=== |
− | + | <pre> | |
− | + | <?xml version="1.0" encoding="UTF-8"?> | |
− | + | <count> | |
− | + | <new_status>1</new_status> | |
− | + | <followers>0</followers> | |
− | + | <dm>1</dm> | |
− | + | <mentions>1</mentions> | |
− | <count> | + | <comments>3</comments> |
− | + | </count> | |
− | JSON示例 | + | </pre> |
− | + | ===JSON示例=== | |
− | + | <pre> | |
− | + | { | |
− | " | + | "comments" : 3, |
− | + | "followers" : 0, | |
− | + | "new_status" : 1, | |
− | + | "dm" : 1, | |
− | + | "mentions" : 1 | |
− | + | } | |
− | * | + | </pre>| |
− | + | useAge= | |
− | + | * 如果只传入since_id,而没有传入with_new_status参数,则返回结果与未传入任何参数时相同。| | |
− | + | otherInfo=无 | |
− | + | }} |
2012年9月24日 (一) 11:34的最后版本
目录 |
statuses/unread
获取当前用户Web主站未读消息数,包括:
- 是否有新微博消息
- 最新提到“我”的微博消息数
- 新评论数
- 新私信数
- 新粉丝数。
此接口对应的清零接口为statuses/reset_count。
URL
http://api.t.sina.com.cn/statuses/unread.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
true
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
with_new_status | false | int,默认为0。 | 1表示结果中包含new_status字段,0表示结果不包含new_status字段。new_status字段表示是否有新微博消息,1表示有,0表示没有 |
since_id | false | int64 | 参数值为微博id。该参数需配合with_new_status参数使用,返回since_id之后,是否有新微博消息产生 |
注意事项
- 如果只传入since_id,而没有传入with_new_status参数,则返回结果与未传入任何参数时相同。
返回结果
XML示例
<?xml version="1.0" encoding="UTF-8"?> <count> <new_status>1</new_status> <followers>0</followers> <dm>1</dm> <mentions>1</mentions> <comments>3</comments> </count>
JSON示例
{ "comments" : 3, "followers" : 0, "new_status" : 1, "dm" : 1, "mentions" : 1 }
其他
无
文档更新时间: 2012-09-24