Statuses/friends
(→XML) |
(→使用说明) |
||
第34行: | 第34行: | ||
=== 使用说明=== | === 使用说明=== | ||
− | * | + | * 如果没有提供cursor参数,将只返回最前面的100个关注列表。当以Json方式返回时,返回结构会稍有不同。 |
− | + | ||
=== 返回结果 === | === 返回结果 === |
2010年11月23日 (二) 18:02的版本
目录 |
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个关注列表。当以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'].' ;'); }