Statuses/comment

跳转到: 导航, 搜索
(PHP示例)
(返回结果)
第163行: 第163行:
 
       },
 
       },
 
     }
 
     }
 +
{{param_status}}
 +
{{param_user}}
 +
{{param_comment}}
  
 
=== 使用示例===
 
=== 使用示例===

2010年9月2日 (四) 13:50的版本

目录

statuses/comment

对一条微博信息进行评论。请求必须用POST方式提交。为防止重复,发布的信息与最后一条评论信息一样话,将会被忽略。

URL

curl http://api.t.sina.com.cn/statuses/comment.format

格式

xml, json

HTTP请求方式

POST

是否需要身份验证

true

请求数限制

true

请求参数

  • id 必填参数, 要评论的微博id
  • cid 选填参数, 要评论的评论id
  • comment. 必填参数, 评论内容。必须做URLEncode,信息内容不超过140个汉字。

使用说明

  • 如果没有登录或超过发布上限,将返回403错误
  • 如果id或cid不存在,将返回400错误
  • 系统将忽略重复发布的评论信息。每次发布将比较最后一条发布评论消息,如果一样将被忽略。因此用户不能连续提交相同信息。发布成功返回发布的信息ID,否则返回为空。

返回结果

  • 评论成功后返回评论的详细内容

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
<comment>
   <created_at>Mon Dec 28 10:39:24 +0800 2009</created_at>
   <id>40406</id>(评论ID)
   <text>abcdef</text>
   <source>
     <a id="0" href="http://t.sina.com.cn">Web</a>
   </source>
   <user>
     <id>11075</id>
     <screen_name>name_11075</screen_name>
     <name>name_11075</name>
     <province></province>
     <city></city>
     <location></location>
     <description></description>
     <url>http://timyang.net</url>
     <profile_image_url>http://tp4.sinaimg.cn/11075/50/0</profile_image_url>
     <domain>11075</domain>
     <gender></gender>
     <followers_count>22</followers_count>
     <friends_count>30</friends_count>
     <statuses_count>0</statuses_count>
     <favourites_count>0</favourites_count>
     <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at>
     <following>false</following>
     <verified>false</verified>
     <geo_enabled>false</geo_enabled>
   </user>
   <status>
     <created_at>Mon Dec 28 10:37:59 +0800 2009</created_at>
     <id>19105</id>
     <text>测试中国</text>
     <source>
       <a id="0" href="http://t.sina.com.cn">Web</a>
     </source>
     <favorited>false</favorited>
     <truncated>false</truncated>
     <geo/>
     <in_reply_to_status_id></in_reply_to_status_id>
     <in_reply_to_user_id></in_reply_to_user_id>
     <in_reply_to_screen_name></in_reply_to_screen_name>
     <user>
       <id>11075</id>
       <screen_name>name_11075</screen_name>
       <name>name_11075</name>
       <province></province>
       <city></city>
       <location></location>
       <description></description>
       <url>http://timyang.net</url>
       <profile_image_url>http://tp4.sinaimg.cn/11075/50/0</profile_image_url>
       <domain>11075</domain>
       <gender></gender>
       <followers_count>22</followers_count>
       <friends_count>30</friends_count>
       <statuses_count>0</statuses_count>
       <favourites_count>0</favourites_count>
       <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at>
       <following>false</following>
       <verified>false</verified>
       <geo_enabled>false</geo_enabled>
     </user>
   </status>
 </comment>

JSON示例:

   {"created_at":"Thu Jan 07 09:00:32 +0800 2010",
   "id":203065,
   "text":"commenttest",
   "source":"<a id=\"0\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">Web</a>",
   "user":
{"id":11051, "screen_name":"name_11051", "name":"name_11051", "province":"0", "city":"0", "location":"", "description":"", "url":"", "profile_image_url":"http://tp4.sinaimg.cn/11051/50/0", "domain":"11051", "followers_count":27, "friends_count":60, "statuses_count":0, "favourites_count":1, "created_at":"Thu Jan 01 08:00:00 +0800 1970", "following":false, "geo_enabled":false, "verified":true, "status":
{"created_at":"Wed Jan 06 11:36:30 +0800 2010", "id":142246, "text":"凤飞飞", "source":"<a id=\"0\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">Web</a>", "favorited":false, "truncated":false, "in_reply_to_status_id":"", "in_reply_to_user_id":"", "in_reply_to_screen_name":"", "geo":null, "apiState":3}
}, "status":
{"created_at":"Wed Jan 06 19:02:40 +0800 2010", "id":142277, "text":"111111111111111111111", "source":"<a id=\"0\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">Web</a>", "favorited":false, "truncated":false, "in_reply_to_status_id":"", "in_reply_to_user_id":"", "in_reply_to_screen_name":"", "geo":null, "user":
{"id":11057, "screen_name":"name_11057", "name":"name_11057", "province":"0", "city":"0", "location":"", "description":"", "url":"", "profile_image_url":"http://tp2.sinaimg.cn/11057/50/0", "domain":"11057", "followers_count":19, "friends_count":101, "statuses_count":0, "favourites_count":0, "created_at":"Thu Jan 01 08:00:00 +0800 1970", "following":false, "geo_enabled":false, "verified":false} }, }

字段说明 - 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,如果不是转发,则没有此字段

字段说明 - 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标示,是否微博认证用户

字段说明 - comment

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

使用示例

  • xml:

curl -u uid:password -d "source=appkey&id=12345&comment=playing with cURL and the Sina API" http://api.t.sina.com.cn/statuses/comment.xml

  • json:

curl -u uid:password -d "source=appkey&id=12345&comment=playing with cURL and the Sina API" http://api.t.sina.com.cn/statuses/comment.json

Java示例

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

package weibo4j.examples;

import weibo4j.Status;
import weibo4j.Weibo;

public class UpdateComment {

	/**
	 * 对一条微博信息进行评论
	 * @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);
       	Status status = weibo.updateStatus("测试12345");//发表新微博信息
       	Thread.sleep(1000);
       	String sid = status.getId()+"";//微博id
       	System.out.println(sid + " : "+ status.getText()+"  "+status.getCreatedAt());
       	weibo.updateComment("测试评论", sid, null);//对刚发表的微博进行评论
       	Comment comment = weibo.updateComment("测试评论", sid, null);
       	System.out.println(comment.getId() + " : " + comment.getText() + "  " + comment.getCreatedAt());
		} 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/comment
// 对一条微博信息进行评论
$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );
//发表新微博信息
$msg = $c->update("测试发表微博");
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;
}
//微博id
$sid = $msg['id'];
echo($sid." : ".$msg['text']." ".$msg["created_at"]);
sleep(5);
//对刚发表的微博进行评论
$msg = $c->send_comment($sid,"测试评论",null);
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;
}
echo($msg['id'].' : '.$msg['text'].'  '.$msg['created_at']);