friends/ids

返回用户关注对象uid列表

URL

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

格式

xml, json

HTTP请求方式

GET

是否需要登录

True

请求数限制

True

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

请求参数

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

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

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

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

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

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

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

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

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

o 示例: http://api.t.sina.com.cn/friends/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/friends/timyang.xml?source=appkey or curl -u uid:password http://api.t.sina.com.cn/friends/ids/timyang.xml?source=appkey or curl -u uid:password http://api.t.sina.com.cn/friends/ids/timyang.xml?cursor=3&source=appkey

• json

curl -u uid:password http://api.t.sina.com.cn/friends/timyang.json?source=appkey or curl -u uid:password http://api.t.sina.com.cn/friends/ids/timyang.json?source=appkey or curl -u uid:password http://api.t.sina.com.cn/friends/ids/timyang.json?cursor=3&source=appkey

Java示例

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

package weibo4j.examples.ids;

import weibo4j.Weibo;
import weibo4j.WeiboException;
public class GetFriendsIDs {

	/**
	 * 获取用户关注对象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).getFriendsIDs(1748033497).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]);
			weibo.setToken("ea9751fb23b109b59ff415df99f611a8", "b71b4df1dc85c336c15fc79330ecad0b");
		}else {//用户登录方式
//    		weibo.setUserId(args[0]);//用户名/ID
//    		weibo.setPassword(args[1]);//密码
			weibo.setUserId("hezhou414@126.com");
   		weibo.setPassword("hezhou88");
		}
		return weibo;
	}
}

PHP示例

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

//friends/ids
//获取用户关注对象uid列表 
$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->oauth->get('http://api.t.sina.com.cn/friends/ids/1765783921.json');
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 (isset($msg['ids'])){
	$id_list = $msg['ids'];
	foreach($id_list as $friend){
		echo($friend.' ; ');
	}
}