(创建新页面为 '{{api_desc_v2| uri=comments/show| desc=根据微博ID返回某条微博的评论列表| httpMethod=GET| needAuth=是| level={{Api_L1}}| rateLimit=是| params={{api_args|id|true|…') |
|||
(未显示3个用户的5个中间版本) | |||
第12行: | 第12行: | ||
{{api_args|page|false|int|返回结果的页码,默认为1。}} | {{api_args|page|false|int|返回结果的页码,默认为1。}} | ||
{{api_args|filter_by_author|false|int|作者筛选类型,0:全部、1:我关注的人、2:陌生人,默认为0。}}| | {{api_args|filter_by_author|false|int|作者筛选类型,0:全部、1:我关注的人、2:陌生人,默认为0。}}| | ||
+ | apiToolPara=key1=id&value1=3481474642286341| | ||
+ | relat_qa=<html><div id="relat_qa" data="comments"></div></html>| | ||
result= | result= | ||
− | <pre> | + | <pre class="brush:js"> |
− | + | { | |
+ | "comments": [ | ||
+ | { | ||
+ | "created_at": "Wed Jun 01 00:50:25 +0800 2011", | ||
+ | "id": 12438492184, | ||
+ | "text": "love your work.......", | ||
+ | "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", | ||
+ | "mid": "202110601896455629", | ||
+ | "user": { | ||
+ | "id": 1404376560, | ||
+ | "screen_name": "zaku", | ||
+ | "name": "zaku", | ||
+ | "province": "11", | ||
+ | "city": "5", | ||
+ | "location": "北京 朝阳区", | ||
+ | "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", | ||
+ | "url": "http://blog.sina.com.cn/zaku", | ||
+ | "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", | ||
+ | "domain": "zaku", | ||
+ | "gender": "m", | ||
+ | "followers_count": 1204, | ||
+ | "friends_count": 447, | ||
+ | "statuses_count": 2908, | ||
+ | "favourites_count": 0, | ||
+ | "created_at": "Fri Aug 28 00:00:00 +0800 2009", | ||
+ | "following": false, | ||
+ | "allow_all_act_msg": false, | ||
+ | "remark": "", | ||
+ | "geo_enabled": true, | ||
+ | "verified": false, | ||
+ | "allow_all_comment": true, | ||
+ | "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", | ||
+ | "verified_reason": "", | ||
+ | "follow_me": false, | ||
+ | "online_status": 0, | ||
+ | "bi_followers_count": 215 | ||
+ | }, | ||
+ | "status": { | ||
+ | "created_at": "Tue May 31 17:46:55 +0800 2011", | ||
+ | "id": 11488058246, | ||
+ | "text": "求关注。", | ||
+ | "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", | ||
+ | "favorited": false, | ||
+ | "truncated": false, | ||
+ | "in_reply_to_status_id": "", | ||
+ | "in_reply_to_user_id": "", | ||
+ | "in_reply_to_screen_name": "", | ||
+ | "geo": null, | ||
+ | "mid": "5612814510546515491", | ||
+ | "reposts_count": 8, | ||
+ | "comments_count": 9, | ||
+ | "annotations": [], | ||
+ | "user": { | ||
+ | "id": 1404376560, | ||
+ | "screen_name": "zaku", | ||
+ | "name": "zaku", | ||
+ | "province": "11", | ||
+ | "city": "5", | ||
+ | "location": "北京 朝阳区", | ||
+ | "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", | ||
+ | "url": "http://blog.sina.com.cn/zaku", | ||
+ | "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", | ||
+ | "domain": "zaku", | ||
+ | "gender": "m", | ||
+ | "followers_count": 1204, | ||
+ | "friends_count": 447, | ||
+ | "statuses_count": 2908, | ||
+ | "favourites_count": 0, | ||
+ | "created_at": "Fri Aug 28 00:00:00 +0800 2009", | ||
+ | "following": false, | ||
+ | "allow_all_act_msg": false, | ||
+ | "remark": "", | ||
+ | "geo_enabled": true, | ||
+ | "verified": false, | ||
+ | "allow_all_comment": true, | ||
+ | "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", | ||
+ | "verified_reason": "", | ||
+ | "follow_me": false, | ||
+ | "online_status": 0, | ||
+ | "bi_followers_count": 215 | ||
+ | } | ||
+ | } | ||
+ | }, | ||
+ | ... | ||
+ | ], | ||
+ | "previous_cursor": 0, | ||
+ | "next_cursor": 0, | ||
+ | "total_number": 7 | ||
+ | } | ||
</pre>| | </pre>| | ||
− | resultDes= | + | resultDes={{Rdes_comment}}| |
− | useAge= | + | useAge= |
+ | *只返回授权用户的评论,非授权用户的评论将不返回; | ||
+ | *使用官方移动SDK调用,可多返回30%的非授权用户的评论; | ||
+ | | | ||
otherInfo=无 | otherInfo=无 | ||
− | }} | + | }}{{#a:showgrade}} |
2015年3月30日 (一) 11:45的最后版本
comments/show
根据微博ID返回某条微博的评论列表
URL
https://api.weibo.com/2/comments/show.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:普通接口
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
id | true | int64 | 需要查询的微博ID。 |
since_id | false | int64 | 若指定此参数,则返回ID比since_id大的评论(即比since_id时间晚的评论),默认为0。 |
max_id | false | int64 | 若指定此参数,则返回ID小于或等于max_id的评论,默认为0。 |
count | false | int | 单页返回的记录条数,默认为50。 |
page | false | int | 返回结果的页码,默认为1。 |
filter_by_author | false | int | 作者筛选类型,0:全部、1:我关注的人、2:陌生人,默认为0。 |
注意事项
- 只返回授权用户的评论,非授权用户的评论将不返回;
- 使用官方移动SDK调用,可多返回30%的非授权用户的评论;
调用样例及调试工具
返回结果
JSON示例
{ "comments": [ { "created_at": "Wed Jun 01 00:50:25 +0800 2011", "id": 12438492184, "text": "love your work.......", "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", "mid": "202110601896455629", "user": { "id": 1404376560, "screen_name": "zaku", "name": "zaku", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", "url": "http://blog.sina.com.cn/zaku", "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", "domain": "zaku", "gender": "m", "followers_count": 1204, "friends_count": 447, "statuses_count": 2908, "favourites_count": 0, "created_at": "Fri Aug 28 00:00:00 +0800 2009", "following": false, "allow_all_act_msg": false, "remark": "", "geo_enabled": true, "verified": false, "allow_all_comment": true, "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 215 }, "status": { "created_at": "Tue May 31 17:46:55 +0800 2011", "id": 11488058246, "text": "求关注。", "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "geo": null, "mid": "5612814510546515491", "reposts_count": 8, "comments_count": 9, "annotations": [], "user": { "id": 1404376560, "screen_name": "zaku", "name": "zaku", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", "url": "http://blog.sina.com.cn/zaku", "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", "domain": "zaku", "gender": "m", "followers_count": 1204, "friends_count": 447, "statuses_count": 2908, "favourites_count": 0, "created_at": "Fri Aug 28 00:00:00 +0800 2009", "following": false, "allow_all_act_msg": false, "remark": "", "geo_enabled": true, "verified": false, "allow_all_comment": true, "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 215 } } }, ... ], "previous_cursor": 0, "next_cursor": 0, "total_number": 7 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
created_at | string | 评论创建时间 |
id | int64 | 评论的ID |
text | string | 评论的内容 |
source | string | 评论的来源 |
user | object | 评论作者的用户信息字段 详细 |
mid | string | 评论的MID |
idstr | string | 字符串型的评论ID |
status | object | 评论的微博信息字段 详细 |
reply_comment | object | 评论来源评论,当本评论属于对另一评论的回复时返回此字段 |
其他
无
相关问题
到 帮助中心 查看更多问题或提问
文档更新时间: 2015-03-30