favorites/create

Favorite a weibo.

URL

http://api.t.sina.com.cn/favorites/create.(json%7Cxml)

Supported Formats

XML/JSON

HTTP Request Method

POST

Requires Authentication

true
See the Authorization Mechanism Statement for authorization details

Requests Count Limitation

true
See the Interface Access Rights Statement for the Request Count Limitaiton details.

Request Parameters

Notes

• 403 error is returned if the session is unauthenticated or out of API limitation.
• 400 error is returned if the favorite ID doesn’t exist.
• Weibo itself is returned if API is successfully called.

Example Request

XML

curl -u "username:password" "http://api.t.sina.com.cn/favorites/create.xml?source=appkey&id=12345"

JSON

curl -u "username:password" "http://api.t.sina.com.cn/favorites/create.json?source=appkey&id=12345"

Response

XML Example

<?xml version="1.0" encoding="UTF-8"?>
    <status>
    <created_at>Mon Nov 29 16:08:43 +0800 2010</created_at>
    <id>3958728723</id>
    <text>各位开发者，我们的论坛上线啦~http://sinaurl.cn/h4FWc7 欢迎大家的参与~另外，关于技术相关的问题，可以在论坛上提出，也可以@微博API 这个官方技术支持账号哦~感谢大家对开放平台的支持~[呵呵]</text>
    <source>
      <a href="http://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/>
    <user>
      <id>11051</id>
      <screen_name>微博开放平台</screen_name>
      <name>微博开放平台</name>
      <province>11</province>
      <city>8</city>
      <location>北京 海淀区</location>
      <description>新浪微博开放平台市场推广官方账号，如有技术问题，请@微博API或者发私信给微博API</description>
      <url>http://open.t.sina.com.cn/</url>
      <profile_image_url>http://tp4.sinaimg.cn/11051/50/1280283165/1</profile_image_url>
      <domain>openapi</domain>
      <gender>m</gender>
      <followers_count>13034</followers_count>
      <friends_count>5</friends_count>
      <statuses_count>157</statuses_count>
      <favourites_count>0</favourites_count>
      <created_at>Wed Jan 20 00:00:00 +0800 2010</created_at>
      <following>false</following>
      <verified>true</verified>
      <allow_all_act_msg>true</allow_all_act_msg>
      <geo_enabled>true</geo_enabled>
    </user>
  </status>

JSON Example

    {
        "created_at" : "Mon Nov 29 16:08:43 +0800 2010",
        "text" : "各位开发者，我们的论坛上线啦~http://sinaurl.cn/h4FWc7 欢迎大家的参与~另外，关于技术相关的问题，可以在论坛上提出，也可以@微博API 这个官方技术支持账号哦~感谢大家对开放平台的支持~[呵呵]",
        "truncated" : false,
        "in_reply_to_status_id" : "",
        "in_reply_to_screen_name" : "",
        "geo" : null,
        "user" : 
        {
            "name" : "微博开放平台",
            "domain" : "openapi",
            "geo_enabled" : true,
            "followers_count" : 13034,
            "statuses_count" : 157,
            "favourites_count" : 0,
            "city" : "8",
            "description" : "新浪微博开放平台市场推广官方账号，如有技术问题，请@微博API或者发私信给微博API",
            "verified" : true,
            "id" : 11051,
            "gender" : "m",
            "friends_count" : 5,
            "screen_name" : "微博开放平台",
            "allow_all_act_msg" : true,
            "following" : false,
            "url" : "http://open.t.sina.com.cn/",
            "profile_image_url" : "http://tp4.sinaimg.cn/11051/50/1280283165/1",
            "created_at" : "Wed Jan 20 00:00:00 +0800 2010",
            "province" : "11",
            "location" : "北京 海淀区"
        },
        "favorited" : false,
        "in_reply_to_user_id" : "",
        "id" : 3958728723,
        "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
    }

Others

Java Example

Please download Java SDK from . Weibo SDK Development Kit Dowload Site
Sample Code:

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 Example

Please download PHP SDK with OAUTH supported from Weibo SDK Development Kit Dowload Site
. Sample Code:

//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']);
}