2010年7月2日 (五) 09:58的版本

followers/ids

返回用户粉丝uid列表，注意目前接口最多只返回5000个粉丝。

URL

http://api.t.sina.com.cn/followers/ids.format

格式

xml, json

HTTP请求方式

GET

是否需要身份验证

false

请求参数

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

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

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

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

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

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

• cursor. 选填参数. 单页只能包含5000个id，为了获取更多则cursor默认从-1开始，通过增加或减少cursor来获取更多的关注列表

o 示例: http://api.t.sina.com.cn/followers/ids.xml?cursor=-1

o 示例: http://api.t.sina.com.cn/followers/ids.xml?cursor=1300794057949944903

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

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

使用说明

• 如果没有提供cursor参数，将只返回最前面的5000个粉丝id

返回结果

XML示例:

<?xml version="1.0" encoding="UTF-8"?> 
<id_list>
    <ids>
         <id>9448</id>
         <id>16825</id>
         ......
    </ids>
    <next_cursor>3</next_cursor>
    <previous_cursor>0</previous_cursor>
</id_list>

JSON示例：

 {"ids":
  [9448,
   16825,
   .....
   ],
   "next_cursor":3,
   "previous_cursor":0}

使用示例

• xml:

curl -u uid:password http://api.t.sina.com.cn/followers/ids.xml?source=appkey curl -u uid:password http://api.t.sina.com.cn/followers/ids/timyang.xml?source=appkey curl -u uid:password http://api.t.sina.com.cn/followers/ids/timyang.xml?cursor=1&source=appkey

• josn:

curl -u uid:password http://api.t.sina.com.cn/followers/ids.xml?source=appkey curl -u uid:password http://api.t.sina.com.cn/followers/ids/timyang.xml?source=appkey curl -u uid:password http://api.t.sina.com.cn/followers/ids/timyang.xml?cursor=1&source=appkey

Java示例

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

package weibo4j.examples.ids;

import weibo4j.Weibo;
import weibo4j.WeiboException; 

public class GetFollowersIDs {

	/**
	 * 获取用户粉丝对象uid列表 
	 * @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
			int[] ids = getWeibo(true,args).getFollowersIDs(args[2]).getIDs();
			for(int id : ids) {
				System.out.println(id);
			}
		} 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;
	}
}