Statuses/unread
(→请求参数) |
|||
第1行: | 第1行: | ||
− | + | {{api_desc2| | |
− | + | uri=statuses/unread | | |
− | + | desc=获取当前用户[http://t.sina.com.cn Web主站]未读消息数,包括最新微博消息数,最新提到“我”的微博消息数,新评论数,新私信数,新粉丝数。此接口对应的清零接口为[[statuses/reset_count]]。| | |
− | + | format=XML/JSON| | |
− | + | 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> | <pre> | ||
− | + | <?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> | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
</pre> | </pre> | ||
+ | ===JSON示例=== | ||
+ | <pre> | ||
+ | { | ||
+ | "comments" : 3, | ||
+ | "followers" : 0, | ||
+ | "new_status" : 1, | ||
+ | "dm" : 1, | ||
+ | "mentions" : 1 | ||
+ | } | ||
+ | </pre>| | ||
+ | useAge= | ||
+ | * 如果只传入since_id,而没有传入with_new_status参数,则返回结果与未传入任何参数时相同。| | ||
+ | otherInfo=无 | ||
+ | }} |
2010年12月1日 (三) 17:27的版本
目录 |
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 }
其他
无