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

statuses/followers

返回用户的粉丝列表，并返回粉丝的最新微博。按粉丝的关注时间倒序返回，每次返回100个,通过cursor参数来取得多于100的粉丝。注意目前接口最多只返回5000个粉丝。

URL

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

格式

xml, json

HTTP请求方式

GET

是否需要身份验证

true

请求数限制

true

请求参数

• id. 选填参数. 要获取粉丝的 UID或微博昵称

o 示例: http://api.t.sina.com.cn/statuses/followers/12345.json or http://api.t.sina.com.cn/statuses/followers/bob.xml

• user_id. 选填参数. 要获取的UID

o 示例: http://api.t.sina.com.cn/statuses/followers.xml?user_id=1401881

• screen_name. 选填参数. 要获取的微博昵称

o 示例: http://api.t.sina.com.cn/statuses/followers.xml?screen_name=101010

• cursor. 选填参数. 单页只能包含100个粉丝列表，为了获取更多则cursor默认从-1开始，通过增加或减少cursor来获取更多的，如果没有下一页，则next_cursor返回0

粉丝列表 o 示例: http://api.t.sina.com.cn/statuses/followers/barackobama.xml?cursor=-1 o 示例: http://api.t.sina.com.cn/statuses/followers/barackobama.xml?cursor=1300794057949944903

• count. 可选参数. 每次返回的最大记录数（即页面大小），不大于200,默认返回20。

o 示例: http://api.t.sina.com.cn/statuses/followers/bob.xml?&count=200

使用说明

• 为了保护用户隐私，只有用户设置了公开或对粉丝设置了公开的数据才会返回。
• 如果没有提供cursor参数，将只返回最前面的100个关注列表

返回结果

XML示例:

 <?xml version="1.0" encoding="UTF-8"?>
 <users_list>
 <users type="array">
  <user>
   <id>11075</id>
   <screen_name>11075</screen_name>
   <name>11075</name>
   <province>广东</province>
   <city>广州</city>
   <location>广东 广州</location>
   <description>blog: timyang.net</description>
   <url>http://timyang.net</url>
   <profile_image_url>http://portrait.sinaimg.cn/11075/50#.jpg</profile_image_url>
   <domain></domain>
   <gender></gender>
   <followers_count>0</followers_count>
   <friends_count>0</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>
   <status>
     <created_at>Fri Dec 25 17:57:27 +0800 2009</created_at>
     <id>19093</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>
   </status>
  </user>
 ...................不分页没有此数据.................
  <next_cursor>1299072354878293926</next_cursor>
  <previous_cursor>0</previous_cursor>
 ..................................................
 </users_list>

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:

curl -u uid:password http://api.t.sina.com.cn/statuses/followers.xml?source=appkey

• json:

curl -u uid:password http://api.t.sina.com.cn/statuses/followers.json?source=appkey

Java示例

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

package weibo4j.examples;

import java.util.List;
import weibo4j.User;
import weibo4j.Weibo;
import weibo4j.WeiboException;

public class GetFollowers {

	/**
	 * 返回用户关注对象列表，并返回最新微博文章。
	 * @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(false,args);
			List<User> list = weibo.getFollowersStatuses();
			for(User user : list) {
				System.out.println(user.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验证之版本）
代码示例如下:

//Statuses/followers
//返回用户关注对象列表，并返回最新微博文章。
$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );

//用户ID
$u_id = "u_id";
$msg = $c->followers(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 $follower){
	echo($follower['id'].' : '.$follower['name'].'  '.$follower['created_at'].' ;');
}