Favorites/create
目录 |
favorites/create
收藏一条微博消息。
URL
http://api.t.sina.com.cn/favorites/create.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
POST
是否需要登录
true
关于授权机制，参见授权机制声明
请求数限制
true
关于请求数限制，参见接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| source | true | string | 申请应用时分配的AppKey，调用接口时候代表应用的唯一身份。（采用OAuth授权方式不需要此参数） |
| id | true | int64 | 要收藏的微博消息ID。 |
注意事项
- 如果没有登录或超过频率限制，将返回403错误
- 收藏ID不存在，将返回400错误
- 收藏成功返回收藏的微博信息
返回结果
XML示例
<?xml version="1.0" encoding="UTF-8"?>
<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>true</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>true</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>
JSON示例
{
"created_at" : "Thu Mar 18 19:07:05 +0800 2010",
"text" : "这么小就入党了 敬仰~",
"truncated" : false,
"retweeted_status" :
{
"created_at" : "Thu Mar 18 19:05:52 +0800 2010",
"text" : "班里开始交团费了，跟我没关系",
"truncated" : false,
"in_reply_to_status_id" : "",
"in_reply_to_screen_name" : "",
"geo" : null,
"user" :
{
"name" : "高考铅笔亚克西",
"domain" : "kimmy14",
"geo_enabled" : false,
"followers_count" : 1330,
"statuses_count" : 3354,
"favourites_count" : 0,
"city" : "1",
"description" : "在通往高考的路上乳摇狂奔，偶尔发骚回头抛个媚眼骂句操蛋，切不可以为姐就是招之即上挥之自摸的小娘儿们。好不容易成年了，姐要更加有湿想嗯哼。",
"verified" : false,
"id" : 1654703984,
"gender" : "f",
"friends_count" : 755,
"screen_name" : "高考铅笔亚克西",
"allow_all_act_msg" : false,
"following" : false,
"url" : "",
"profile_image_url" : "http://tp1.sinaimg.cn/1654703984/50/1264140632",
"created_at" : "Mon Oct 19 00:00:00 +0800 2009",
"province" : "42",
"location" : "湖北 武汉"
},
"favorited" : true,
"in_reply_to_user_id" : "",
"id" : 27657268,
"source" : "<a href=\"http://news.sina.com.cn/wap/wbk.html/\" rel=\"nofollow\">新浪微博手机版</a>"
},
"in_reply_to_status_id" : "",
"in_reply_to_screen_name" : "",
"geo" : null,
"user" :
{
"name" : "老王",
"domain" : "hotpixel",
"geo_enabled" : false,
"followers_count" : 1567,
"statuses_count" : 6776,
"favourites_count" : 0,
"city" : "8",
"description" : "哼。。。 花样真多。 讨厌。",
"verified" : false,
"id" : 1152759471,
"gender" : "m",
"friends_count" : 202,
"screen_name" : "老王",
"allow_all_act_msg" : false,
"following" : false,
"url" : "http://1",
"profile_image_url" : "http://tp4.sinaimg.cn/1152759471/50/1263371934",
"created_at" : "Fri Aug 28 00:00:00 +0800 2009",
"province" : "11",
"location" : "北京 海淀区"
},
"favorited" : true,
"in_reply_to_user_id" : "",
"id" : 1,
"source" : "<a href=\"http://news.sina.com.cn/wap/wbk.html/\" rel=\"nofollow\">新浪微博手机版</a>"
}
其他
Java示例
请从 微博SDK开发包下载 下载Java SDK
代码示例如下:
package weibo4j.examples;
import java.util.List;
import weibo4j.Status;
import weibo4j.Weibo;
import weibo4j.WeiboException;
public class CreateFavorite {
/**
* 添加收藏
* @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 {
//args[2]:收藏id
Status status = getWeibo(true,args).createFavorite(Long.parseLong(args[2]));
System.out.println(status.toString());
} catch (WeiboException 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验证之版本）
代码示例如下:
//favorites/create
//添加收藏
$c = new WeiboClient( WB_AKEY ,
WB_SKEY ,
$_SESSION['last_key']['oauth_token'] ,
$_SESSION['last_key']['oauth_token_secret'] );
//收藏id
$sid='sid';
$msg = $c->add_to_favorites( $sid );
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;
}
if ($msg['text']){
echo($msg['text']);
}
