Weibo Platform Logo

微博开放平台

weibo

Statuses/friends

跳转到： 导航, 搜索
(→Usage examples:)
 
（未显示8个用户的40个中间版本）
第1行： 第1行：
−
== statuses/friends ==
+
{{api_desc2|
−
Returns a user's friends, each with current status inline. They are ordered by the order in which the user followed them, most recently followed first, 100 at a time. (Please note that the result set isn't guaranteed to be 100 every time as suspended users will be filtered out.) Use the cursor option to access older friends. With no user specified, request defaults to the authenticated user's friends. It's also possible to request another user's friends list via the id, screen_name or user_id parameter.
+
uri=statuses/friends|
 +
desc=获取用户关注列表及每个关注用户的最新一条微博，返回结果按关注时间倒序排列，最新关注的用户排在最前面。|
 +
format=XML/JSON|
 +
httpMethod=GET|
 +
needAuth=true|
 +
rateLimit=true|
 +
params={{api_args|:id|false|int64/string|用户ID(int64)或者昵称(string)。该参数为一个REST风格参数。调用示例见注意事项}}
 +
{{api_args|user_id|false|int64|用户ID，主要是用来区分用户ID跟微博昵称。当微博昵称为数字导致和用户ID产生歧义，特别是当微博昵称和用户ID一样的时候，建议使用该参数}}
 +
{{api_args|screen_name|false|string|微博昵称，主要是用来区分用户UID跟微博昵称，当二者一样而产生歧义的时候，建议使用该参数}}
 +
{{api_args|cursor|false|int|用于分页请求，请求第1页cursor传-1，在返回的结果中会得到next_cursor字段，表示下一页的cursor。next_cursor为0表示已经到记录末尾。}}
 +
{{api_args|count|false|int，默认20，最大200|每页返回的最大记录数，最大不能超过200，默认为20。}}
 +
{{api_args_colspan|1=<font style="color:#ee3333">:id, user_id, screen_name 可以任选一个参数，在3个都不提供的情况下，系统返回当前登录用户的关注列表</font>}}|
 +
getParam=&user_id=11051|
 +
postParam=|
 +
result=
 +
===XML示例===
 +
<pre>
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
<users>
 +
  <user>
 +
    <id>1473612611</id>
 +
    <screen_name>周立清</screen_name>
 +
    <name>周立清</name>
 +
    <province>14</province>
 +
    <city>1</city>
 +
    <location>山西 太原</location>
 +
    <description>新浪微博开放平台（open.t.sina.com.cn），欢迎广大站长朋友前来聊聊：13718188488 、 010-62676120 、QQ：3653550、liqing3@staff.sina.com.cn</description>
 +
    <url>http://www.linger.cn</url>
 +
    <profile_image_url>http://tp4.sinaimg.cn/1473612611/50/1284048157/1</profile_image_url>
 +
    <domain>xyzlinger</domain>
 +
    <gender>m</gender>
 +
    <followers_count>4652</followers_count>
 +
    <friends_count>1060</friends_count>
 +
    <statuses_count>3897</statuses_count>
 +
    <favourites_count>5</favourites_count>
 +
    <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
 +
    <following>false</following>
 +
    <verified>true</verified>
 +
    <allow_all_act_msg>true</allow_all_act_msg>
 +
    <geo_enabled>true</geo_enabled>
 +
    <remark/>
 +
    <status>
 +
      <created_at>Fri Dec 03 13:49:07 +0800 2010</created_at>
 +
      <id>4051881415</id>
 +
      <text>哈哈，看到新浪@微博大屏幕 了[哈哈]，第一条是@飞象网项立刚 的微博，给力！[good]</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/>
 +
      <retweeted_status>
 +
        <created_at>Fri Dec 03 13:45:02 +0800 2010</created_at>
 +
        <id>4051797049</id>
 +
        <text>#3G创新应用#工信部电信研究院通信信息所所长徐玉正在演讲，数据很详实，人也很漂亮。</text>
 +
        <source>
 +
          <a href="http://t.sina.com.cn/mobile/msg.php">彩信</a>
 +
        </source>
 +
        <favorited>false</favorited>
 +
        <truncated>false</truncated>
 +
        <geo/>
 +
        <in_reply_to_status_id/>
 +
        <in_reply_to_user_id/>
 +
        <in_reply_to_screen_name/>
 +
        <thumbnail_pic>http://ww3.sinaimg.cn/thumbnail/4c1526eajw6dbzdl54fmoj.jpg</thumbnail_pic>
 +
        <bmiddle_pic>http://ww3.sinaimg.cn/bmiddle/4c1526eajw6dbzdl54fmoj.jpg</bmiddle_pic>
 +
        <original_pic>http://ww3.sinaimg.cn/large/4c1526eajw6dbzdl54fmoj.jpg</original_pic>
 +
        <user>
 +
          <id>1276454634</id>
 +
          <screen_name>孙慧飞象</screen_name>
 +
          <name>孙慧飞象</name>
 +
          <province>11</province>
 +
          <city>5</city>
 +
          <location>北京 朝阳区</location>
 +
          <description>远树两行山倒影，轻舟一叶水平流</description>
 +
          <url>http://blog.sina.com.cn/sunhuiblog</url>
 +
          <profile_image_url>http://tp3.sinaimg.cn/1276454634/50/1283155247/0</profile_image_url>
 +
          <domain>sunhui123</domain>
 +
          <gender>f</gender>
 +
          <followers_count>871</followers_count>
 +
          <friends_count>314</friends_count>
 +
          <statuses_count>552</statuses_count>
 +
          <favourites_count>4</favourites_count>
 +
          <created_at>Fri Oct 16 00:00:00 +0800 2009</created_at>
 +
          <following>false</following>
 +
          <verified>true</verified>
 +
          <allow_all_act_msg>true</allow_all_act_msg>
 +
          <geo_enabled>true</geo_enabled>
 +
        </user>
 +
        <annotations/>
 +
      </retweeted_status>
 +
      <annotations/>
 +
    </status>
 +
  </user>
 +
  ...
 +
  <next_cursor>1</next_cursor>
 +
  <previous_cursor>0</previous_cursor>
 +
</users>
 +
</pre>
 +
===JSON示例===
 +
<pre>
 +
{
 +
    "users" :
 +
    [
 +
        {
 +
            "name" : "周立清",
 +
            "domain" : "xyzlinger",
 +
            "geo_enabled" : true,
 +
            "followers_count" : 4652,
 +
            "statuses_count" : 3897,
 +
            "favourites_count" : 5,
 +
            "city" : "1",
 +
            "description" : "新浪微博开放平台（open.t.sina.com.cn），欢迎广大站长朋友前来聊聊：13718188488 、 010-62676120 、QQ：3653550、liqing3@staff.sina.com.cn",
 +
            "verified" : true,
 +
            "remark" : "",
 +
            "status" :
 +
            {
 +
                "created_at" : "Fri Dec 03 13:49:07 +0800 2010",
 +
                "text" : "哈哈，看到新浪@微博大屏幕 了[哈哈]，第一条是@飞象网项立刚 的微博，给力！[good]",
 +
                "truncated" : false,
 +
                "retweeted_status" :
 +
                {
 +
                    "created_at" : "Fri Dec 03 13:45:02 +0800 2010",
 +
                    "text" : "#3G创新应用#工信部电信研究院通信信息所所长徐玉正在演讲，数据很详实，人也很漂亮。",
 +
                    "bmiddle_pic" : "http://ww3.sinaimg.cn/bmiddle/4c1526eajw6dbzdl54fmoj.jpg",
 +
                    "original_pic" : "http://ww3.sinaimg.cn/large/4c1526eajw6dbzdl54fmoj.jpg",
 +
                    "truncated" : false,
 +
                    "in_reply_to_status_id" : "",
 +
                    "annotations" :
 +
                    [
  
−
=== URL: ===
+
                    ],
−
http://api.t.sina.com.cn/statuses/friends.format
+
                    "in_reply_to_screen_name" : "",
−
+
                    "geo" : null,
−
=== Formats: ===
+
                    "user" :
−
xml, json
+
                    {
 +
                        "name" : "孙慧飞象",
 +
                        "domain" : "sunhui123",
 +
                        "geo_enabled" : true,
 +
                        "followers_count" : 871,
 +
                        "statuses_count" : 552,
 +
                        "favourites_count" : 4,
 +
                        "city" : "5",
 +
                        "description" : "远树两行山倒影，轻舟一叶水平流",
 +
                        "verified" : true,
 +
                        "id" : 1276454634,
 +
                        "gender" : "f",
 +
                        "friends_count" : 314,
 +
                        "screen_name" : "孙慧飞象",
 +
                        "allow_all_act_msg" : true,
 +
                        "following" : false,
 +
                        "url" : "http://blog.sina.com.cn/sunhuiblog",
 +
                        "profile_image_url" : "http://tp3.sinaimg.cn/1276454634/50/1283155247/0",
 +
                        "created_at" : "Fri Oct 16 00:00:00 +0800 2009",
 +
                        "province" : "11",
 +
                        "location" : "北京 朝阳区"
 +
                    },
 +
                    "favorited" : false,
 +
                    "thumbnail_pic" : "http://ww3.sinaimg.cn/thumbnail/4c1526eajw6dbzdl54fmoj.jpg",
 +
                    "in_reply_to_user_id" : "",
 +
                    "id" : 4051797049,
 +
                    "source" : "<a href=\"http://t.sina.com.cn/mobile/msg.php\" rel=\"nofollow\">彩信</a>"
 +
                },
 +
                "in_reply_to_status_id" : "",
 +
                "annotations" :
 +
                [
  
−
=== HTTP Method(s): ===
+
                ],
−
GET
+
                "in_reply_to_screen_name" : "",
 +
                "geo" : null,
 +
                "favorited" : false,
 +
                "in_reply_to_user_id" : "",
 +
                "id" : 4051881415,
 +
                "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
 +
            },
 +
            "id" : 1473612611,
 +
            "gender" : "m",
 +
            "friends_count" : 1060,
 +
            "screen_name" : "周立清",
 +
            "allow_all_act_msg" : true,
 +
            "following" : false,
 +
            "url" : "http://www.linger.cn",
 +
            "profile_image_url" : "http://tp4.sinaimg.cn/1473612611/50/1284048157/1",
 +
            "created_at" : "Fri Aug 28 00:00:00 +0800 2009",
 +
            "province" : "14",
 +
            "location" : "山西 太原"
 +
        },
 +
        ...
 +
    ],
 +
    "next_cursor" : 1,
 +
    "previous_cursor" : 0
 +
}
 +
</pre>
 +
{{param_user}}
 +
{{param_status}}|
 +
useAge=
 +
* :id为REST风格的参数，使用该参数的URL为：<br/> http://api.t.sina.com.cn/statuses/friends/:id.format <br/> 使用示例如下：<br/> http://api.t.sina.com.cn/statuses/friends/11051.xml?source=appkey<br/>http://api.t.sina.com.cn/statuses/friends/timyang.json?source=appkey
 +
* 如果没有提供cursor参数，将只返回最前面的20个关注用户。|
 +
otherInfo=
 +
 
 +
===Java示例===
 +
请从 [[SDK | 微博SDK开发包下载]] 下载Java SDK<br>
 +
代码示例如下:
 +
package weibo4j.examples;
 
   
 
   
−
=== Requires Authentication (about authentication): ===
+
import java.util.List;
−
false unless requesting it from a protected user; if getting this data of a protected user, you must auth (and be allowed to see that user).
+
 
   
 
   
−
=== API rate limited (about rate limiting): ===
+
  import weibo4j.Weibo;
−
1 call per request
+
  import weibo4j.User;
−
 
+
−
=== Parameters: ===
+
−
* id. Optional. The ID or screen name of the user for whom to request a list of friends. 
+
−
o Example: http://api.t.sina.com.cn/statuses/friends/12345.json or http://api.t.sina.com.cn/statuses/friends/bob.xml
+
−
* user_id. Optional. Specfies the ID of the user for whom to return the list of friends. Helpful for disambiguating when a valid user ID is also a valid screen name.
+
−
o Example: http://api.t.sina.com.cn/statuses/friends.xml?user_id=1401881
+
−
* screen_name.  Optional.  Specfies the screen name of the user for whom to return the list of friends. Helpful for disambiguating when a valid screen name is also a user ID.
+
−
o Example: http://api.t.sina.com.cn/statuses/friends.xml?screen_name=101010
+
−
* cursor. Optional. Breaks the results into pages. A single page contains 100 users. This is recommended for users who are following many users. Provide a value of  -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
+
−
o Example: http://api.t.sina.com.cn/statuses/friends/barackobama.xml?cursor=-1
+
−
o Example: http://api.t.sina.com.cn/statuses/friends/barackobama.xml?cursor=1300794057949944903
+
−
 
+
 
   
 
   
−
=== Unpaginated Response ===
+
  public class GetFriends {
−
(about return values): XML example (truncated):
+
   
−
  <?xml version="1.0" encoding="UTF-8"?>
+
    /**
−
  <users>
+
    * Usage: java -DWeibo4j.oauth.consumerKey=[consumer key] -DWeibo4j.oauth.consumerSecret=
−
  <user>
+
[consumer secret] Weibo4j.examples.GetFriends [accessToken] [accessSecret]
−
  <id>1401881</id>
+
    * @param args message
−
  <name>Doug Williams</name>
+
    */
−
  <screen_name>dougw</screen_name>
+
    public static void main(String[] args) {
−
  <location>San Francisco, CA</location>
+
        try {
−
  <description>Twitter API Support. Internet, greed, users, dougw and opportunities are my passions.</description>
+
        System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
−
  <profile_image_url>http://s3.amazonaws.com/twitter_production/profile_images/59648642/avatar_normal.png</profile_image_url>
+
        System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
−
  <url>http://www.igudo.com</url>
+
       
−
  <protected>false</protected>
+
            Weibo weibo = new Weibo();
−
  <followers_count>1031</followers_count>
+
           
−
  <profile_background_color>9ae4e8</profile_background_color>
+
            weibo.setToken(args[0], args[1]);
−
  <profile_text_color>000000</profile_text_color>
+
 
−
  <profile_link_color>0000ff</profile_link_color>
+
try {
−
  <profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color>
+
List<User> list= weibo.getFriendsStatuses();
−
  <profile_sidebar_border_color>87bc44</profile_sidebar_border_color>
+
System.out.println("Successfully get Friends to [" + list + "].");
−
  <friends_count>293</friends_count>
+
} catch (Exception e1) {
−
  <created_at>Sun Mar 18 06:42:26 +0000 2007</created_at>
+
// TODO Auto-generated catch block
−
  <favourites_count>0</favourites_count>
+
e1.printStackTrace();
−
  <utc_offset>-18000</utc_offset>
+
}
−
  <time_zone>Eastern Time (US & Canada)</time_zone>
+
            System.exit(0);
−
  <profile_background_image_url>http://s3.amazonaws.com/twitter_production/profile_background_images/2752608/twitter_bg_grass.jpg</profile_background_image_url>
+
        } catch (Exception ioe) {
−
  <profile_background_tile>false</profile_background_tile>
+
            System.out.println("Failed to read the system input.");
−
  <statuses_count>3390</statuses_count>
+
            System.exit( -1);
−
  <notifications>false</notifications>
+
        }
−
  <following>false</following>
+
    }
−
  <verified>true</verified>
+
}
−
  <status>
+
===PHP示例===
−
  <created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>
+
请从 [[SDK | 微博SDK开发包下载]] 处下载PHP SDK（支持OAuth验证之版本）<br>  
−
  <id>1472669360</id>
+
代码示例如下:
−
  <text>At least I can get your humor through tweets. RT @abdur: I don't mean this in a bad way, but genetically speaking your a cul-de-sac.</text>
+
<pre>
−
  <source><a href="http://www.tweetdeck.com/">TweetDeck</a></source>
+
//Statuses/friends
−
  <truncated>false</truncated>
+
$c = new WeiboClient( WB_AKEY ,
−
  <in_reply_to_status_id></in_reply_to_status_id>
+
                      WB_SKEY ,
−
  <in_reply_to_user_id></in_reply_to_user_id>
+
                      $_SESSION['last_key']['oauth_token'] ,
−
  <favorited>false</favorited>
+
                      $_SESSION['last_key']['oauth_token_secret']  );
−
  <in_reply_to_screen_name></in_reply_to_screen_name>
+
//用户ID
−
  </status>
+
$u_id = "User_ID";
−
  </user>
+
$msg = $c->friends(false, false, $u_id);
−
  ... truncated ...
+
if ($msg === false || $msg === null){
−
</users>
+
echo "Error occured";
−
 
+
return false;
−
=== Paginated Response ===
+
}
−
(about return values): XML example (truncated):
+
if (isset($msg['error_code']) && isset($msg['error'])){
−
<?xml version="1.0" encoding="UTF-8"?>
+
echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
−
<users_list>
+
return false;
−
<users type="array">
+
}
−
<user>
+
foreach($msg as $friend){
−
  <id>422</id>
+
echo($friend['id'].' : '.$friend['name'].'  '.$friend['created_at'].' ;');
−
  <name>Jason Shellen</name>
+
}
−
  <screen_name>shellen</screen_name>
+
</pre>
−
  <location>iPhone: 37.889321,-122.173345</location>
+
}}
−
  <description>CEO and founder of Thing Labs, makers of Brizzly! Former Blogger/Google dude, father of two little dudes.</description>
+
−
  <profile_image_url>http://a3.twimg.com/profile_images/369449595/js_glasses_suit_normal.png</profile_image_url>
+
−
  <url>http://www.shellen.com</url>
+
−
  <protected>false</protected>
+
−
  <followers_count>8526</followers_count>
+
−
  <profile_background_color>9ae4e8</profile_background_color>
+
−
  <profile_text_color>000000</profile_text_color>
+
−
  <profile_link_color>0000ff</profile_link_color>
+
−
  <profile_sidebar_fill_color>DCDCDC</profile_sidebar_fill_color>
+
−
  <profile_sidebar_border_color>D22900</profile_sidebar_border_color>
+
−
  <friends_count>375</friends_count>
+
−
  <created_at>Thu Jul 06 22:36:22 +0000 2006</created_at>
+
−
  <favourites_count>1179</favourites_count>
+
−
  <utc_offset>-28800</utc_offset>
+
−
  <time_zone>Pacific Time (US & Canada)</time_zone>
+
−
  <profile_background_image_url>http://a1.twimg.com/profile_background_images/382/IMG_0158.jpg</profile_background_image_url>
+
−
  <profile_background_tile>true</profile_background_tile>
+
−
  <statuses_count>2710</statuses_count>
+
−
  <notifications></notifications>
+
−
  <verified>false</verified>
+
−
  <following></following>
+
−
  <status>
+
−
    <created_at>Thu Sep 24 19:31:58 +0000 2009</created_at>
+
−
    <id>4349531340</id>
+
−
    <text>I think @jasonfried just went from "prickly fellow" to "kind of a dick" in my book. Eyes on your own paper Fried.</text>
+
−
    <source><a href="http://www.brizzly.com" rel="nofollow">Brizzly</a></source>
+
−
    <truncated>false</truncated>
+
−
    <in_reply_to_status_id></in_reply_to_status_id>
+
−
    <in_reply_to_user_id></in_reply_to_user_id>
+
−
    <favorited>false</favorited>
+
−
    <in_reply_to_screen_name></in_reply_to_screen_name>
+
−
  </status>
+
−
</user>
+
−
  ... truncated ...
+
−
</users>
+
−
<next_cursor>1299072354878293926</next_cursor>
+
−
<previous_cursor>0</previous_cursor>
+
−
</users_list>
+
−
 
+
−
=== Notes: ===
+
−
* If the cursor parameter is not provided, only the first 100 users in the set will be returned.
+
−
* The previously documented page-based pagination mechanism is still in production, but will be deprecated. Please migrate to cursor-based pagination for increased reliability and performance.
+
−
 
+
−
=== Usage examples: ===
+
−
cURL (about cURL):
+
−
 
+
−
curl -u user:password http://api.t.sina.com.cn/statuses/friends.xml
+
−
 
+
−
curl http://api.t.sina.com.cn/statuses/friends/dougw.xml
+
−
 
+
−
curl http://api.t.sina.com.cn/statuses/friends/dougw.xml?cursor=-1
+

2012年9月24日 (一) 11:38的最后版本

目录

statuses/friends

获取用户关注列表及每个关注用户的最新一条微博，返回结果按关注时间倒序排列，最新关注的用户排在最前面。

URL

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

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

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

请求数限制

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

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey，调用接口时候代表应用的唯一身份。（采用OAuth授权方式不需要此参数）
:id false int64/string 用户ID(int64)或者昵称(string)。该参数为一个REST风格参数。调用示例见注意事项
user_id false int64 用户ID，主要是用来区分用户ID跟微博昵称。当微博昵称为数字导致和用户ID产生歧义，特别是当微博昵称和用户ID一样的时候，建议使用该参数
screen_name false string 微博昵称，主要是用来区分用户UID跟微博昵称，当二者一样而产生歧义的时候，建议使用该参数
cursor false int 用于分页请求，请求第1页cursor传-1，在返回的结果中会得到next_cursor字段，表示下一页的cursor。next_cursor为0表示已经到记录末尾。
count false int，默认20，最大200 每页返回的最大记录数，最大不能超过200，默认为20。
:id, user_id, screen_name 可以任选一个参数，在3个都不提供的情况下，系统返回当前登录用户的关注列表

注意事项

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <id>1473612611</id>
    <screen_name>周立清</screen_name>
    <name>周立清</name>
    <province>14</province>
    <city>1</city>
    <location>山西 太原</location>
    <description>新浪微博开放平台（open.t.sina.com.cn），欢迎广大站长朋友前来聊聊：13718188488 、 010-62676120 、QQ：3653550、liqing3@staff.sina.com.cn</description>
    <url>http://www.linger.cn</url>
    <profile_image_url>http://tp4.sinaimg.cn/1473612611/50/1284048157/1</profile_image_url>
    <domain>xyzlinger</domain>
    <gender>m</gender>
    <followers_count>4652</followers_count>
    <friends_count>1060</friends_count>
    <statuses_count>3897</statuses_count>
    <favourites_count>5</favourites_count>
    <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
    <following>false</following>
    <verified>true</verified>
    <allow_all_act_msg>true</allow_all_act_msg>
    <geo_enabled>true</geo_enabled>
    <remark/>
    <status>
      <created_at>Fri Dec 03 13:49:07 +0800 2010</created_at>
      <id>4051881415</id>
      <text>哈哈，看到新浪@微博大屏幕 了[哈哈]，第一条是@飞象网项立刚 的微博，给力！[good]</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/>
      <retweeted_status>
        <created_at>Fri Dec 03 13:45:02 +0800 2010</created_at>
        <id>4051797049</id>
        <text>#3G创新应用#工信部电信研究院通信信息所所长徐玉正在演讲，数据很详实，人也很漂亮。</text>
        <source>
          <a href="http://t.sina.com.cn/mobile/msg.php">彩信</a>
        </source>
        <favorited>false</favorited>
        <truncated>false</truncated>
        <geo/>
        <in_reply_to_status_id/>
        <in_reply_to_user_id/>
        <in_reply_to_screen_name/>
        <thumbnail_pic>http://ww3.sinaimg.cn/thumbnail/4c1526eajw6dbzdl54fmoj.jpg</thumbnail_pic>
        <bmiddle_pic>http://ww3.sinaimg.cn/bmiddle/4c1526eajw6dbzdl54fmoj.jpg</bmiddle_pic>
        <original_pic>http://ww3.sinaimg.cn/large/4c1526eajw6dbzdl54fmoj.jpg</original_pic>
        <user>
          <id>1276454634</id>
          <screen_name>孙慧飞象</screen_name>
          <name>孙慧飞象</name>
          <province>11</province>
          <city>5</city>
          <location>北京 朝阳区</location>
          <description>远树两行山倒影，轻舟一叶水平流</description>
          <url>http://blog.sina.com.cn/sunhuiblog</url>
          <profile_image_url>http://tp3.sinaimg.cn/1276454634/50/1283155247/0</profile_image_url>
          <domain>sunhui123</domain>
          <gender>f</gender>
          <followers_count>871</followers_count>
          <friends_count>314</friends_count>
          <statuses_count>552</statuses_count>
          <favourites_count>4</favourites_count>
          <created_at>Fri Oct 16 00:00:00 +0800 2009</created_at>
          <following>false</following>
          <verified>true</verified>
          <allow_all_act_msg>true</allow_all_act_msg>
          <geo_enabled>true</geo_enabled>
        </user>
        <annotations/>
      </retweeted_status>
      <annotations/>
    </status>
  </user>
  ...
  <next_cursor>1</next_cursor>
  <previous_cursor>0</previous_cursor>
</users>

JSON示例

{
    "users" : 
    [
        {
            "name" : "周立清",
            "domain" : "xyzlinger",
            "geo_enabled" : true,
            "followers_count" : 4652,
            "statuses_count" : 3897,
            "favourites_count" : 5,
            "city" : "1",
            "description" : "新浪微博开放平台（open.t.sina.com.cn），欢迎广大站长朋友前来聊聊：13718188488 、 010-62676120 、QQ：3653550、liqing3@staff.sina.com.cn",
            "verified" : true,
            "remark" : "",
            "status" : 
            {
                "created_at" : "Fri Dec 03 13:49:07 +0800 2010",
                "text" : "哈哈，看到新浪@微博大屏幕 了[哈哈]，第一条是@飞象网项立刚 的微博，给力！[good]",
                "truncated" : false,
                "retweeted_status" : 
                {
                    "created_at" : "Fri Dec 03 13:45:02 +0800 2010",
                    "text" : "#3G创新应用#工信部电信研究院通信信息所所长徐玉正在演讲，数据很详实，人也很漂亮。",
                    "bmiddle_pic" : "http://ww3.sinaimg.cn/bmiddle/4c1526eajw6dbzdl54fmoj.jpg",
                    "original_pic" : "http://ww3.sinaimg.cn/large/4c1526eajw6dbzdl54fmoj.jpg",
                    "truncated" : false,
                    "in_reply_to_status_id" : "",
                    "annotations" : 
                    [

                    ],
                    "in_reply_to_screen_name" : "",
                    "geo" : null,
                    "user" : 
                    {
                        "name" : "孙慧飞象",
                        "domain" : "sunhui123",
                        "geo_enabled" : true,
                        "followers_count" : 871,
                        "statuses_count" : 552,
                        "favourites_count" : 4,
                        "city" : "5",
                        "description" : "远树两行山倒影，轻舟一叶水平流",
                        "verified" : true,
                        "id" : 1276454634,
                        "gender" : "f",
                        "friends_count" : 314,
                        "screen_name" : "孙慧飞象",
                        "allow_all_act_msg" : true,
                        "following" : false,
                        "url" : "http://blog.sina.com.cn/sunhuiblog",
                        "profile_image_url" : "http://tp3.sinaimg.cn/1276454634/50/1283155247/0",
                        "created_at" : "Fri Oct 16 00:00:00 +0800 2009",
                        "province" : "11",
                        "location" : "北京 朝阳区"
                    },
                    "favorited" : false,
                    "thumbnail_pic" : "http://ww3.sinaimg.cn/thumbnail/4c1526eajw6dbzdl54fmoj.jpg",
                    "in_reply_to_user_id" : "",
                    "id" : 4051797049,
                    "source" : "<a href=\"http://t.sina.com.cn/mobile/msg.php\" rel=\"nofollow\">彩信</a>"
                },
                "in_reply_to_status_id" : "",
                "annotations" : 
                [

                ],
                "in_reply_to_screen_name" : "",
                "geo" : null,
                "favorited" : false,
                "in_reply_to_user_id" : "",
                "id" : 4051881415,
                "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
            },
            "id" : 1473612611,
            "gender" : "m",
            "friends_count" : 1060,
            "screen_name" : "周立清",
            "allow_all_act_msg" : true,
            "following" : false,
            "url" : "http://www.linger.cn",
            "profile_image_url" : "http://tp4.sinaimg.cn/1473612611/50/1284048157/1",
            "created_at" : "Fri Aug 28 00:00:00 +0800 2009",
            "province" : "14",
            "location" : "山西 太原"
        },
        ...
    ],
    "next_cursor" : 1,
    "previous_cursor" : 0
}

字段说明 - 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
代码示例如下: 

package weibo4j.examples;

import java.util.List;

import weibo4j.Weibo;
import weibo4j.User;

public class GetFriends {

	    /**
	     * Usage: java -DWeibo4j.oauth.consumerKey=[consumer key] -DWeibo4j.oauth.consumerSecret=
		 [consumer secret] Weibo4j.examples.GetFriends [accessToken] [accessSecret]
	     * @param args message
	     */
	    public static void main(String[] args) {
	        try {
	        	System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
	        	System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
	        	
	            Weibo weibo = new Weibo();
	            
	            weibo.setToken(args[0], args[1]);
	  
				 try {
					List<User> list= weibo.getFriendsStatuses();	
					System.out.println("Successfully get Friends to [" + list + "].");
				} catch (Exception e1) {
					// TODO Auto-generated catch block
					e1.printStackTrace();
				}
	            System.exit(0);
	        } catch (Exception ioe) {
	            System.out.println("Failed to read the system input.");
	            System.exit( -1);
	        }
	    }
}

PHP示例

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

//Statuses/friends
$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );
//用户ID
$u_id = "User_ID";
$msg = $c->friends(false, false, $u_id);
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 $friend){
	echo($friend['id'].' : '.$friend['name'].'  '.$friend['created_at'].' ;');
}
来自“http://open.weibo.com/wiki/index.php?title=Statuses/friends&oldid=9456”
文档更新时间: 2012-09-24

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA