Statuses/friends
(→使用说明) |
(→statuses/friends) |
||
第1行: | 第1行: | ||
== statuses/friends == | == statuses/friends == | ||
− | + | 获取用户关注列表及每个关注用户最新一条微博,返回结果按关注时间倒序排列,最新关注的用户在最前面。 | |
=== URL=== | === URL=== | ||
第6行: | 第6行: | ||
=== 格式=== | === 格式=== | ||
− | + | XML, JSON | |
=== HTTP请求方式=== | === HTTP请求方式=== | ||
第18行: | 第18行: | ||
=== 请求参数=== | === 请求参数=== | ||
− | * id. | + | * id. 可选参数,用户uid |
# o 示例: http://api.t.sina.com.cn/statuses/friends/12345.json | # o 示例: http://api.t.sina.com.cn/statuses/friends/12345.json | ||
# http://api.t.sina.com.cn/statuses/friends/12345.xml | # http://api.t.sina.com.cn/statuses/friends/12345.xml | ||
− | * user_id. | + | * user_id. 可选参数. 用户uid, 和id作用相同。id和user_id任选一个 |
# o 示例: http://api.t.sina.com.cn/statuses/friends.xml?user_id=1401881 | # o 示例: http://api.t.sina.com.cn/statuses/friends.xml?user_id=1401881 | ||
− | * screen_name. | + | * screen_name. 可选参数,微博昵称 |
# o 示例: http://api.t.sina.com.cn/statuses/friends.xml?screen_name=101010 | # o 示例: http://api.t.sina.com.cn/statuses/friends.xml?screen_name=101010 | ||
− | * cursor. | + | * cursor. 可选参数,用于分页请求,请求第1页cursor传-1,在返回的结果中会得到next_cursor字段,表示下一页的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=-1 | ||
# o 示例: http://api.t.sina.com.cn/statuses/friends/timyang.xml?cursor=1300794057949944903 | # o 示例: http://api.t.sina.com.cn/statuses/friends/timyang.xml?cursor=1300794057949944903 | ||
− | * count. | + | * count. 可选参数,每页返回的最大记录数,最大不能超过200,默认为20。 |
− | # o 示例: http://api.t.sina.com.cn/statuses/friends/bob.xml? | + | # o 示例: http://api.t.sina.com.cn/statuses/friends/bob.xml?count=200 |
=== 使用说明=== | === 使用说明=== | ||
− | * | + | * id, user_id, screen_name 可以任选一个参数,在3个都不提供的情况下,系统返回当前用户的关注列表。 |
+ | * 如果没有提供cursor参数,将只返回最前面的20个关注用户。 | ||
+ | * 当以JSON方式返回时,返回结构会稍有不同。 | ||
=== 返回结果 === | === 返回结果 === |
2010年11月29日 (一) 19:43的版本
目录 |
statuses/friends
获取用户关注列表及每个关注用户最新一条微博,返回结果按关注时间倒序排列,最新关注的用户在最前面。
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, 和id作用相同。id和user_id任选一个
- screen_name. 可选参数,微博昵称
- cursor. 可选参数,用于分页请求,请求第1页cursor传-1,在返回的结果中会得到next_cursor字段,表示下一页的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。
使用说明
- id, user_id, screen_name 可以任选一个参数,在3个都不提供的情况下,系统返回当前用户的关注列表。
- 如果没有提供cursor参数,将只返回最前面的20个关注用户。
- 当以JSON方式返回时,返回结构会稍有不同。
返回结果
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>358</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>1748040</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>2</next_cursor> //仅带cursor参数的时候有此字段 <previous_cursor>0</previous_cursor> //仅带cursor参数的时候有此字段 </users>
JSON
{ "users":[ { "id":1644072040, "screen_name":"董玉庆", "name":"董玉庆", "province":"11", "city":"8", "location":"北京 海淀区", "description":"汝之素年,谁予锦时 Sina 微博开放平台对外合作,010-82626545,13911461126,yuqing1@staff.sina.com.cn", "url":"http://1", "profile_image_url":"http://tp1.sinaimg.cn/1644072040/50/1283421854", "domain":"janedyq", "gender":"f", "followers_count":358, "friends_count":303, "statuses_count":1179, "favourites_count":1, "created_at":"Mon Aug 31 00:00:00 +0800 2009", "following":false, "allow_all_act_msg":false, "geo_enabled":false, "verified":false, "status":{ "created_at":"Mon Sep 13 17:24:29 +0800 2010", "id":2590421720, "text":"猫咪睡姿 超级萌的猫猫睡姿 http://sinaurl.cn/h4Zxto", "source":"<a href=\"http://www.xtalk.cn/\" rel=\"nofollow\">xweibo1</a>", "favorited":false, "truncated":false, "in_reply_to_status_id":"", "in_reply_to_user_id":"", "in_reply_to_screen_name":"", "thumbnail_pic":"http://ss13.sinaimg.cn/thumbnail/61fe8c6849020a9c494bc&690", "bmiddle_pic":"http://ss13.sinaimg.cn/bmiddle/61fe8c6849020a9c494bc&690", "original_pic":"http://ss13.sinaimg.cn/orignal/61fe8c6849020a9c494bc&690", "geo":null } }, { "id":1197161814, "screen_name":"李开复", "name":"李开复", "province":"11", "city":"1000", "location":"北京", "description":"创新工场CEO", "url":"http://blog.sina.com.cn/kaifulee", "profile_image_url":"http://tp3.sinaimg.cn/1197161814/50/1283203482", "domain":"kaifulee", "gender":"m", "followers_count":1748040, "friends_count":120, "statuses_count":725, "favourites_count":1, "created_at":"Fri Aug 28 00:00:00 +0800 2009", "following":false, "allow_all_act_msg":false, "geo_enabled":false, "verified":true, "status":{ "created_at":"Mon Sep 13 09:41:41 +0800 2010", "id":2578485930, "text":"移动开发者大会 -- 10月21-22日 CSDN和创新工场将举办2010中国移动开发者大会,除了中国的移动互联网专家,特别请到第一次来华的Disney/Tapulous创始人、Twitter联合创始人、Google/Admob产品负责人等。http://sinaurl.cn/h9Mw0X", "source":"<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>", "favorited":false, "truncated":false, "in_reply_to_status_id":"", "in_reply_to_user_id":"", "in_reply_to_screen_name":"", "geo":null } } ], "next_cursor":2, //仅带cursor参数的时候有此字段 "previous_cursor":0 //仅带cursor参数的时候有此字段 }
字段说明 - 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'].' ;'); }