Statuses/comments

跳转到: 导航, 搜索

目录

statuses/comments

根据微博消息ID返回某条微博消息的评论列表

URL

http://api.t.sina.com.cn/statuses/comments.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

true
关于授权机制,参见授权机制声明

请求数限制

true
关于请求数限制,参见接口访问权限说明

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
id true int64 指定要获取的评论列表所属的微博消息ID
count false int,默认值20,最大值200。 单页返回的记录条数。
page false int,默认值1。 返回结果的页码。

注意事项

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<comments>
  <comment>
    <created_at>Sat Nov 13 15:57:53 +0800 2010</created_at>
    <id>4476725917</id>
    <text> help</text>
    <user>
      <id>1611511443</id>
      <screen_name>无冷afcold</screen_name>
      <name>无冷afcold</name>
      <province>51</province>
      <city>1</city>
      <location>四川 成都</location>
      <description/>
      <url>http://blog.sina.com.cn/sureceive</url>
      <profile_image_url>http://tp4.sinaimg.cn/1611511443/50/1290602543/1</profile_image_url>
      <domain>atpal</domain>
      <gender>m</gender>
      <followers_count>18</followers_count>
      <friends_count>21</friends_count>
      <statuses_count>69</statuses_count>
      <favourites_count>1</favourites_count>
      <created_at>Tue Oct 20 00:00:00 +0800 2009</created_at>
      <following>false</following>
      <verified>false</verified>
      <allow_all_act_msg>false</allow_all_act_msg>
      <geo_enabled>true</geo_enabled>
      <status>
        <created_at>Sun Nov 28 12:50:17 +0800 2010</created_at>
        <id>3933955277</id>
        <text>我刚加入了“ubuntu军团”微群 http://sinaurl.cn/hbAfsD 推荐大家也来看看~</text>
        <source>
          <a href="http://group.t.sina.com.cn">新浪微群</a>
        </source>
        <favorited>false</favorited>
        <truncated>false</truncated>
        <geo/>
        <in_reply_to_status_id/>
        <in_reply_to_user_id/>
        <in_reply_to_screen_name/>
      </status>
    </user>
    <status>
      <created_at>Thu Mar 18 19:07:05 +0800 2010</created_at>
      <id>1</id>
      <text>这么小就入党了 敬仰~</text>
      <source>
        <a href="http://news.sina.com.cn/wap/wbk.html/">新浪微博手机版</a>
      </source>
      <favorited>false</favorited>
      <truncated>false</truncated>
      <geo/>
      <in_reply_to_status_id/>
      <in_reply_to_user_id/>
      <in_reply_to_screen_name/>
      <user>
        <id>1152759471</id>
        <screen_name>老王</screen_name>
        <name>老王</name>
        <province>11</province>
        <city>8</city>
        <location>北京 海淀区</location>
        <description>哼。。。 花样真多。 讨厌。</description>
        <url>http://1</url>
        <profile_image_url>http://tp4.sinaimg.cn/1152759471/50/1263371934</profile_image_url>
        <domain>hotpixel</domain>
        <gender>m</gender>
        <followers_count>1567</followers_count>
        <friends_count>202</friends_count>
        <statuses_count>6776</statuses_count>
        <favourites_count>0</favourites_count>
        <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
        <following>false</following>
        <verified>false</verified>
        <allow_all_act_msg>false</allow_all_act_msg>
        <geo_enabled>false</geo_enabled>
      </user>
      <retweeted_status>
        <created_at>Thu Mar 18 19:05:52 +0800 2010</created_at>
        <id>27657268</id>
        <text>班里开始交团费了,跟我没关系</text>
        <source>
          <a href="http://news.sina.com.cn/wap/wbk.html/">新浪微博手机版</a>
        </source>
        <favorited>false</favorited>
        <truncated>false</truncated>
        <geo/>
        <in_reply_to_status_id/>
        <in_reply_to_user_id/>
        <in_reply_to_screen_name/>
        <user>
          <id>1654703984</id>
          <screen_name>高考铅笔亚克西</screen_name>
          <name>高考铅笔亚克西</name>
          <province>42</province>
          <city>1</city>
          <location>湖北 武汉</location>
          <description>在通往高考的路上乳摇狂奔,偶尔发骚回头抛个媚眼骂句操蛋,切不可以为姐就是招之即上挥之自摸的小娘儿们。好不容易成年了,姐要更加有湿想嗯哼。</description>
          <url/>
          <profile_image_url>http://tp1.sinaimg.cn/1654703984/50/1264140632</profile_image_url>
          <domain>kimmy14</domain>
          <gender>f</gender>
          <followers_count>1330</followers_count>
          <friends_count>755</friends_count>
          <statuses_count>3354</statuses_count>
          <favourites_count>0</favourites_count>
          <created_at>Mon Oct 19 00:00:00 +0800 2009</created_at>
          <following>false</following>
          <verified>false</verified>
          <allow_all_act_msg>false</allow_all_act_msg>
          <geo_enabled>false</geo_enabled>
        </user>
      </retweeted_status>
    </status>
  </comment>
...
</comments>

JSON示例

[
    {
        "id" : 2794158817,
        "text" : "军训多久?",
        "created_at" : "Fri Sep 03 12:07:14 +0800 2010",
        "user" : 
        {
            "name" : "乖乖的仲夏夜之梦",
            "domain" : "",
            "geo_enabled" : true,
            "followers_count" : 12,
            "statuses_count" : 42,
            "favourites_count" : 2,
            "city" : "13",
            "description" : "",
            "verified" : false,
            "status" : 
            {
                "created_at" : "Wed Dec 01 09:50:24 +0800 2010",
                "text" : "//@优酷网:#优酷分享#周一早上听听16岁小男孩活力的歌声,提提神。开始战斗!",
                "truncated" : false,
                "retweeted_status" : 
                {
                    "created_at" : "Mon Nov 29 08:58:52 +0800 2010",
                    "text" : "【猴姆独家】超震撼!Justin Bieber做客英国偶像激情串烧Somebody To Love和Baby高清完整现场 http://sinaurl.cn/hbyEw3  via@优酷网",
                    "truncated" : false,
                    "in_reply_to_status_id" : "",
                    "in_reply_to_screen_name" : "",
                    "geo" : null,
                    "user" : 
                    {
                        "name" : "Houson猴姆",
                        "domain" : "houson100037",
                        "geo_enabled" : true,
                        "followers_count" : 14840,
                        "statuses_count" : 1496,
                        "favourites_count" : 0,
                        "city" : "10",
                        "description" : "",
                        "verified" : false,
                        "id" : 1258256457,
                        "gender" : "m",
                        "friends_count" : 37,
                        "screen_name" : "Houson猴姆",
                        "allow_all_act_msg" : true,
                        "following" : false,
                        "url" : "http://blog.sina.com.cn/houson100037",
                        "profile_image_url" : "http://tp2.sinaimg.cn/1258256457/50/1283203847/1",
                        "created_at" : "Wed May 19 00:00:00 +0800 2010",
                        "province" : "37",
                        "location" : "山东 威海"
                    },
                    "favorited" : false,
                    "in_reply_to_user_id" : "",
                    "id" : 3950816793,
                    "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
                },
                "in_reply_to_status_id" : "",
                "in_reply_to_screen_name" : "",
                "geo" : null,
                "favorited" : false,
                "in_reply_to_user_id" : "",
                "id" : 3994851987,
                "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
            },
            "id" : 1785964704,
            "gender" : "f",
            "friends_count" : 58,
            "screen_name" : "乖乖的仲夏夜之梦",
            "allow_all_act_msg" : false,
            "following" : false,
            "url" : "",
            "profile_image_url" : "http://tp1.sinaimg.cn/1785964704/50/0",
            "created_at" : "Wed Aug 04 00:00:00 +0800 2010",
            "province" : "43",
            "location" : "湖南 娄底"
        },
        "status" : 
        {
            "created_at" : "Fri Sep 03 11:41:08 +0800 2010",
            "text" : "今日下午回初中看看,然后老同学请吃饭,因为距明天就去报到了,最后的晚餐。希望老天留翻D眼泪等到我军训时先留。。",
            "truncated" : false,
            "in_reply_to_status_id" : "",
            "in_reply_to_screen_name" : "",
            "geo" : null,
            "user" : 
            {
                "name" : "标-心",
                "domain" : "",
                "geo_enabled" : true,
                "followers_count" : 37,
                "statuses_count" : 282,
                "favourites_count" : 0,
                "city" : "1",
                "description" : "见仁见智",
                "verified" : false,
                "id" : 1763124584,
                "gender" : "m",
                "friends_count" : 41,
                "screen_name" : "标-心",
                "allow_all_act_msg" : true,
                "following" : false,
                "url" : "http://blog.163.com/chen_mou/",
                "profile_image_url" : "http://tp1.sinaimg.cn/1763124584/50/1283605697/1",
                "created_at" : "Thu Jun 17 00:00:00 +0800 2010",
                "province" : "44",
                "location" : "广东 广州"
            },
            "favorited" : false,
            "in_reply_to_user_id" : "",
            "id" : 2265657555,
            "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
        }
    },
...
]

字段说明 - comment

  • id: 评论ID
  • text: 评论内容
  • source: 评论来源
  • favorited: 是否收藏
  • truncated: 是否被截断
  • created_at: 评论时间
  • user: 评论人信息,结构参考user
  • status: 评论的微博,结构参考status
  • reply_comment 评论来源,数据结构跟comment一致

字段说明 - user

  • id: 用户UID
  • screen_name: 微博昵称
  • name: 友好显示名称,同微博昵称
  • province: 省份编码(参考省份编码表)
  • city: 城市编码(参考城市编码表)
  • location:地址
  • description: 个人描述
  • url: 用户博客地址
  • profile_image_url: 自定义图像
  • domain: 用户个性化URL
  • gender: 性别,m--男,f--女,n--未知
  • followers_count: 粉丝数
  • friends_count: 关注数
  • statuses_count: 微博数
  • favourites_count: 收藏数
  • created_at: 创建时间
  • following: 是否已关注(此特性暂不支持)
  • verified: 加V标示,是否微博认证用户

字段说明 - status

  • created_at: 创建时间
  • id: 微博ID
  • text: 微博信息内容
  • source: 微博来源
  • favorited: 是否已收藏
  • truncated: 是否被截断
  • in_reply_to_status_id: 回复ID
  • in_reply_to_user_id: 回复人UID
  • in_reply_to_screen_name: 回复人昵称
  • thumbnail_pic: 缩略图
  • bmiddle_pic: 中型图片
  • original_pic:原始图片
  • user: 作者信息
  • retweeted_status: 转发的博文,内容为status,如果不是转发,则没有此字段

其他

Java示例

请从 微博SDK开发包下载 下载Java SDK
代码示意如下:

 public class GetCommentsOfStatus {
 
 	/**
 	 * 获取某条微博消息的评论列表
 	 * @param args
 	 */
 	public static void main(String[] args) {
 	    System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
     	    System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
            try {
         	Weibo weibo = getWeibo(true,args);
         	//args[2]:用户id
         	List<Status> list = weibo.getUserTimeline(args[2]);
        	if(list.size() > 0) {
         		//最新一条微博信息id
         		String sid = list.get(0).getId()+"";
        		//对该微博消息添加评论
         		weibo.updateComment("测试评论", sid , null);
        		
        		weibo.getComments(sid);
        	}
 	    } catch (Exception e) {
 			e.printStackTrace();
            }
 	}
 
 	private static Weibo getWeibo(boolean isOauth,String ... args) {
 		Weibo weibo = new Weibo();
 		if(isOauth) {//oauth验证方式 args[0]:访问的token;args[1]:访问的密匙
 			weibo.setToken(args[0], args[1]);
 		}else {//用户登录方式
     		weibo.setUserId(args[0]);//用户名/ID
    		weibo.setPassword(args[1]);//密码
 		}
 		return weibo;
 	}
 }

PHP示例

请从 微博SDK开发包下载 处下载PHP SDK(支持OAuth验证之版本)
代码示例如下:

//statuses/comments_by_me
$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );
$msg  = $c->comments_by_me();
if ($msg === false || $msg === null){
	echo "Error occured";
	return false;
}
if (isset($msg['error_code']) && isset($msg['error'])){
	echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
	return false;
}
foreach ($msg as $data){
	$user_name = $data['user']['name'];
	$text = $data['text'];
	echo $user_name."=".$text.";";
}
文档更新时间: 2012-09-24