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或微博昵称
- o 示例: http://api.t.sina.com.cn/statuses/friends/12345.json
- http://api.t.sina.com.cn/statuses/friends/12345.xml
- user_id. 选填参数. 要获取的UID
- screen_name. 选填参数. 要获取的微博昵称
- cursor. 选填参数. 单页只能包含100个关注列表，为了获取更多则cursor默认从-1开始，通过增加或减少cursor来获取更多, 如果没有下一页，则next_cursor返回0
的关注列表
- o 示例: http://api.t.sina.com.cn/statuses/friends/timyang.xml?cursor=-1
- o 示例: http://api.t.sina.com.cn/statuses/friends/timyang.xml?cursor=1300794057949944903
- count. 可选参数. 每次返回的最大记录数（即页面大小），不大于200,默认返回20。
使用说明
- 如果没有提供cursor参数，将只返回最前面的100个关注列表
返回结果
XML示例:
<?xml version="1.0" encoding="UTF-8"?>
<users_list>
<users>
<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/friends.xml?source=appkey
- curl -u uid:password http://api.t.sina.com.cn/statuses/friends/timyang.xml?source=appkey
- curl -u uid:password http://api.t.sina.com.cn/statuses/friends/timyang.xml?cursor=-1&source=appkey
- json:
- curl -u uid:password http://api.t.sina.com.cn/statuses/friends.json?source=appkey
- curl -u uid:password http://api.t.sina.com.cn/statuses/friends/timyang.json?source=appkey
- 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'].' ;');
}
