(未显示2个用户的2个中间版本) | |||
第1行: | 第1行: | ||
{{api_desc_v2| | {{api_desc_v2| | ||
uri=friendships/groups/timeline| | uri=friendships/groups/timeline| | ||
− | desc= | + | desc=获取当前登录用户某一好友分组的微博列表| |
httpMethod=GET| | httpMethod=GET| | ||
needAuth=是| | needAuth=是| | ||
第7行: | 第7行: | ||
rateLimit=是| | rateLimit=是| | ||
params= | params= | ||
− | |||
{{api_args|list_id|true|int64|需要查询的好友分组ID,建议使用返回值里的idstr,当查询的为私有分组时,则当前登录用户必须为其所有者。}} | {{api_args|list_id|true|int64|需要查询的好友分组ID,建议使用返回值里的idstr,当查询的为私有分组时,则当前登录用户必须为其所有者。}} | ||
{{api_args|since_id|false|int64|若指定此参数,则返回ID比since_id大的微博(即比since_id时间晚的微博),默认为0。}} | {{api_args|since_id|false|int64|若指定此参数,则返回ID比since_id大的微博(即比since_id时间晚的微博),默认为0。}} | ||
第15行: | 第14行: | ||
{{api_args|base_app|false|int|是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。}} | {{api_args|base_app|false|int|是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。}} | ||
{{api_args|feature|false|int|过滤类型ID,0:全部、1:原创、2:图片、3:视频、4:音乐,默认为0。}}| | {{api_args|feature|false|int|过滤类型ID,0:全部、1:原创、2:图片、3:视频、4:音乐,默认为0。}}| | ||
+ | apiToolPara=key1=list_id&value1=0| | ||
+ | relat_qa=<html><div id="relat_qa" data="friendships/groups/timeline"></div></html>| | ||
result= | result= | ||
<pre> | <pre> | ||
第20行: | 第21行: | ||
"statuses": [ | "statuses": [ | ||
{ | { | ||
− | "created_at": " | + | "created_at": "Wed Oct 24 14:12:57 +0800 2012", |
− | "id": | + | "id": 350465856168738, |
− | "text": " | + | "mid": "350465856168738", |
− | "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", | + | "idstr": "350465856168738", |
+ | "text": "今天看到一句话觉得很有。", | ||
+ | "source": "<a href=\"http://weibo.com/\" rel=\"nofollow\">新浪微博</a>", | ||
"favorited": false, | "favorited": false, | ||
"truncated": false, | "truncated": false, | ||
第30行: | 第33行: | ||
"in_reply_to_screen_name": "", | "in_reply_to_screen_name": "", | ||
"geo": null, | "geo": null, | ||
− | |||
− | |||
− | |||
− | |||
"user": { | "user": { | ||
− | "id": | + | "id": 175827735, |
− | "screen_name": " | + | "idstr": "175827735", |
− | "name": " | + | "screen_name": "张三", |
− | "province": " | + | "name": "张三", |
− | "city": " | + | "province": "13", |
− | "location": " | + | "city": "1", |
− | "description": " | + | "location": "河北 石家庄", |
− | "url": "http://blog.sina.com.cn/ | + | "description": "IT一族", |
− | "profile_image_url": "http:// | + | "url": "http://blog.sina.com.cn/zhangsan122", |
− | "domain": " | + | "profile_image_url": "http://tp2.sinaimg.cn/175827735/50/40005526631/0", |
− | "gender": " | + | "profile_url": "zhangsan122", |
− | "followers_count": | + | "domain": "zhangsan122", |
− | "friends_count": | + | "weihao": "", |
− | "statuses_count": | + | "gender": "f", |
− | "favourites_count": | + | "followers_count": 500, |
− | "created_at": " | + | "friends_count": 145, |
− | "following": | + | "statuses_count": 1053, |
+ | "favourites_count": 13, | ||
+ | "created_at": "Tue Jun 15 10:39:48 +0800 2010", | ||
+ | "following": true, | ||
"allow_all_act_msg": false, | "allow_all_act_msg": false, | ||
− | |||
"geo_enabled": true, | "geo_enabled": true, | ||
"verified": false, | "verified": false, | ||
+ | "verified_type": 220, | ||
+ | "remark": "同学张三", | ||
"allow_all_comment": true, | "allow_all_comment": true, | ||
− | "avatar_large": "http:// | + | "avatar_large": "http://tp2.sinaimg.cn/175827735/180/40005526631/0", |
"verified_reason": "", | "verified_reason": "", | ||
− | "follow_me": | + | "follow_me": true, |
"online_status": 0, | "online_status": 0, | ||
− | "bi_followers_count": | + | "bi_followers_count": 75, |
+ | "lang": "zh-cn" | ||
+ | }, | ||
+ | "reposts_count": 0, | ||
+ | "comments_count": 0, | ||
+ | "attitudes_count": 0, | ||
+ | "mlevel": 0, | ||
+ | "visible": { | ||
+ | "type": 0, | ||
+ | "list_id": 0 | ||
} | } | ||
− | } | + | } |
− | + | ||
], | ], | ||
+ | "hasvisible": false, | ||
"previous_cursor": 0, | "previous_cursor": 0, | ||
− | "next_cursor": | + | "next_cursor": 3504652345931549, |
− | "total_number": | + | "total_number": 2008 |
} | } | ||
</pre>| | </pre>| | ||
resultDes={{Rdes_status}}| | resultDes={{Rdes_status}}| | ||
useAge= | useAge= | ||
− | + | 无 | |
− | + | | | |
− | + | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} |
2012年11月15日 (四) 16:15的最后版本
friendships/groups/timeline
获取当前登录用户某一好友分组的微博列表
URL
https://api.weibo.com/2/friendships/groups/timeline.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:高级接口(需要授权)
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
list_id | true | int64 | 需要查询的好友分组ID,建议使用返回值里的idstr,当查询的为私有分组时,则当前登录用户必须为其所有者。 |
since_id | false | int64 | 若指定此参数,则返回ID比since_id大的微博(即比since_id时间晚的微博),默认为0。 |
max_id | false | int64 | 若指定此参数,则返回ID小于或等于max_id的微博,默认为0。 |
count | false | int | 单页返回的记录条数,最大不超过200,默认为50。 |
page | false | int | 返回结果的页码,默认为1。 |
base_app | false | int | 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 |
feature | false | int | 过滤类型ID,0:全部、1:原创、2:图片、3:视频、4:音乐,默认为0。 |
注意事项
无
调用样例及调试工具
返回结果
JSON示例
{ "statuses": [ { "created_at": "Wed Oct 24 14:12:57 +0800 2012", "id": 350465856168738, "mid": "350465856168738", "idstr": "350465856168738", "text": "今天看到一句话觉得很有。", "source": "<a href=\"http://weibo.com/\" rel=\"nofollow\">新浪微博</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "geo": null, "user": { "id": 175827735, "idstr": "175827735", "screen_name": "张三", "name": "张三", "province": "13", "city": "1", "location": "河北 石家庄", "description": "IT一族", "url": "http://blog.sina.com.cn/zhangsan122", "profile_image_url": "http://tp2.sinaimg.cn/175827735/50/40005526631/0", "profile_url": "zhangsan122", "domain": "zhangsan122", "weihao": "", "gender": "f", "followers_count": 500, "friends_count": 145, "statuses_count": 1053, "favourites_count": 13, "created_at": "Tue Jun 15 10:39:48 +0800 2010", "following": true, "allow_all_act_msg": false, "geo_enabled": true, "verified": false, "verified_type": 220, "remark": "同学张三", "allow_all_comment": true, "avatar_large": "http://tp2.sinaimg.cn/175827735/180/40005526631/0", "verified_reason": "", "follow_me": true, "online_status": 0, "bi_followers_count": 75, "lang": "zh-cn" }, "reposts_count": 0, "comments_count": 0, "attitudes_count": 0, "mlevel": 0, "visible": { "type": 0, "list_id": 0 } } ], "hasvisible": false, "previous_cursor": 0, "next_cursor": 3504652345931549, "total_number": 2008 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
created_at | string | 微博创建时间 |
id | int64 | 微博ID |
mid | int64 | 微博MID |
idstr | string | 字符串型的微博ID |
text | string | 微博信息内容 |
source | string | 微博来源 |
favorited | boolean | 是否已收藏,true:是,false:否 |
truncated | boolean | 是否被截断,true:是,false:否 |
in_reply_to_status_id | string | (暂未支持)回复ID |
in_reply_to_user_id | string | (暂未支持)回复人UID |
in_reply_to_screen_name | string | (暂未支持)回复人昵称 |
thumbnail_pic | string | 缩略图片地址,没有时不返回此字段 |
bmiddle_pic | string | 中等尺寸图片地址,没有时不返回此字段 |
original_pic | string | 原始图片地址,没有时不返回此字段 |
geo | object | 地理信息字段 详细 |
user | object | 微博作者的用户信息字段 详细 |
retweeted_status | object | 被转发的原微博信息字段,当该微博为转发微博时返回 详细 |
reposts_count | int | 转发数 |
comments_count | int | 评论数 |
attitudes_count | int | 表态数 |
mlevel | int | 暂未支持 |
visible | object | 微博的可见性及指定可见分组信息。该object中type取值,0:普通微博,1:私密微博,3:指定分组微博,4:密友微博;list_id为分组的组号 |
pic_ids | object | 微博配图ID。多图时返回多图ID,用来拼接图片url。用返回字段thumbnail_pic的地址配上该返回字段的图片ID,即可得到多个图片url。 |
ad | object array | 微博流内的推广微博ID |
其他
无
相关问题
到 帮助中心 查看更多问题或提问
文档更新时间: 2012-11-15