Weibo Platform Logo

微博开放平台

weibo

Statuses/friends

跳转到： 导航, 搜索

目录

statuses/friends

返回用户关注对象列表，并返回最新微博文章。按关注人的关注时间倒序返回，每次返回N个,通过cursor参数来取得多于N的关注人。当然也可以通过ID,nickname,user_id参数来获取其他人的关注人列表。

URL

http://api.t.sina.com.cn/statuses/friends.format

格式

xml, json

HTTP请求方式

GET

是否需要身份验证

true

请求数限制

true

请求参数

  • id. 选填参数. 要获取的 UID或微博昵称
  1. o 示例: http://api.t.sina.com.cn/statuses/friends/12345.json
  2. http://api.t.sina.com.cn/statuses/friends/12345.xml
  • user_id. 选填参数. 要获取的UID
  1. o 示例: http://api.t.sina.com.cn/statuses/friends.xml?user_id=1401881
  • screen_name. 选填参数. 要获取的微博昵称
  1. o 示例: http://api.t.sina.com.cn/statuses/friends.xml?screen_name=101010
  • cursor. 选填参数. 单页只能包含100个关注列表，为了获取更多则cursor默认从-1开始，通过增加或减少cursor来获取更多, 如果没有下一页，则next_cursor返回0

的关注列表

  1. o 示例: http://api.t.sina.com.cn/statuses/friends/timyang.xml?cursor=-1
  2. o 示例: http://api.t.sina.com.cn/statuses/friends/timyang.xml?cursor=1300794057949944903
  • count. 可选参数. 每次返回的最大记录数（即页面大小），不大于200,默认返回20。
  1. o 示例: http://api.t.sina.com.cn/statuses/friends/bob.xml?&count=200

使用说明

  • 如果没有提供cursor参数，将只返回最前面的100个关注列表


返回结果

XML

 <?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <id>1644072040</id>
    <screen_name>董玉庆</screen_name>
    <name>董玉庆</name>
    <province>11</province>
    <city>8</city>
    <location>北京 海淀区</location>
    <description>汝之素年,谁予锦时 Sina 微博开放平台对外合作，010-82626545,13911461126，yuqing1@staff.sina.com.cn</description>
    <url>http://1</url>
    <profile_image_url>http://tp1.sinaimg.cn/1644072040/50/1283421854</profile_image_url>
    <domain>janedyq</domain>
    <gender>f</gender>
    <followers_count>357</followers_count>
    <friends_count>303</friends_count>
    <statuses_count>1179</statuses_count>
    <favourites_count>1</favourites_count>
    <created_at>Mon Aug 31 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>
    <status>
      <created_at>Mon Sep 13 17:24:29 +0800 2010</created_at>
      <id>2590421720</id>
      <text>猫咪睡姿 超级萌的猫猫睡姿 http://sinaurl.cn/h4Zxto</text>
      <source>
        <a href="http://www.xtalk.cn/">xweibo1</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://ss13.sinaimg.cn/thumbnail/61fe8c6849020a9c494bc&690</thumbnail_pic>
      <bmiddle_pic>http://ss13.sinaimg.cn/bmiddle/61fe8c6849020a9c494bc&690</bmiddle_pic>
      <original_pic>http://ss13.sinaimg.cn/orignal/61fe8c6849020a9c494bc&690</original_pic>
    </status>
  </user>
  <user>
    <id>1197161814</id>
    <screen_name>李开复</screen_name>
    <name>李开复</name>
    <province>11</province>
    <city>1000</city>
    <location>北京</location>
    <description>创新工场CEO</description>
    <url>http://blog.sina.com.cn/kaifulee</url>
    <profile_image_url>http://tp3.sinaimg.cn/1197161814/50/1283203482</profile_image_url>
    <domain>kaifulee</domain>
    <gender>m</gender>
    <followers_count>1748031</followers_count>
    <friends_count>120</friends_count>
    <statuses_count>725</statuses_count>
    <favourites_count>1</favourites_count>
    <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
    <following>false</following>
    <verified>true</verified>
    <allow_all_act_msg>false</allow_all_act_msg>
    <geo_enabled>false</geo_enabled>
    <status>
      <created_at>Mon Sep 13 09:41:41 +0800 2010</created_at>
      <id>2578485930</id>
      <text>移动开发者大会 -- 10月21-22日 CSDN和创新工场将举办2010中国移动开发者大会，除了中国的移动互联网专家，特别请到第一次来华的Disney/Tapulous创始人、Twitter联合创始人、Google/Admob产品负责人等。http://sinaurl.cn/h9Mw0X</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/>
    </status>
  </user>
...................不分页没有此数据.................
  <next_cursor>1299072354878293926</next_cursor>
  <previous_cursor>0</previous_cursor>
 ..................................................
</users>

JSON示例: 

  {"users":
   [{"id":9448,
    "screen_name":"name_9448",
    "name":"name_9448",
    "province":"0",
    "city":"0",
    "location":"",
    "description":"",
    "url":"",
    "profile_image_url":"http://tp1.sinaimg.cn/9448/50/0",
    "domain":"9448",
    "followers_count":30,
    "friends_count":0,
    "statuses_count":0,
    "favourites_count":0,
    "created_at":"Thu Jan 01 08:00:00 +0800 1970",
    "following":false,
    "geo_enabled":false,
    "verified":false},
    {},
    ...
   ]
 ...................不分页没有此数据.................
   ,
   "next_cursor":2,
   "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，如果不是转发，则没有此字段

使用示例

  • xml:
  1. curl -u uid:password http://api.t.sina.com.cn/statuses/friends.xml?source=appkey
  2. curl -u uid:password http://api.t.sina.com.cn/statuses/friends/timyang.xml?source=appkey
  3. curl -u uid:password http://api.t.sina.com.cn/statuses/friends/timyang.xml?cursor=-1&source=appkey
  • json:
  1. curl -u uid:password http://api.t.sina.com.cn/statuses/friends.json?source=appkey
  2. curl -u uid:password http://api.t.sina.com.cn/statuses/friends/timyang.json?source=appkey
  3. curl -u uid:password http://api.t.sina.com.cn/statuses/friends/timyang.json?cursor=-1&source=appkey

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=1995”

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

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