(创建新页面为 '{{api_desc_v2| uri=friendships/groups/timeline/ids| desc=获取某一好友分组的微博ID列表| httpMethod=GET| needAuth=是| level={{Api_L2}}| rateLimit=是| params= {{api_…') |
|||
| 第7行： | 第7行： | ||
rateLimit=是| | rateLimit=是| | ||
params= | params= | ||
| − | {{api_args|list_id|true|int64| | + | {{api_args|uid|false|int64|好友分组的所有者UID，默认不填为当前登录用户。}} |
| + | {{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。}} | ||
{{api_args|max_id|false|int64|若指定此参数，则返回ID小于或等于max_id的微博，默认为0。}} | {{api_args|max_id|false|int64|若指定此参数，则返回ID小于或等于max_id的微博，默认为0。}} | ||
| 第29行： | 第30行： | ||
</pre>| | </pre>| | ||
resultDes=无| | resultDes=无| | ||
| − | useAge= | + | useAge= |
| + | *当要查询的分组为私有分组时，当前登录用户必须为分组的所有者； | ||
| + | *当前登录用户不是指定好友分组的所有者时，只能获取所有人可见的公开分组、和组内成员可见的公开分组（此时当前登录用户必须是组内成员）的微博； | ||
| + | *最多返回最新300条微博；| | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} | ||
2012年5月30日 (三) 18:09的版本
friendships/groups/timeline/ids
获取某一好友分组的微博ID列表
URL
https://api.weibo.com/2/friendships/groups/timeline/ids.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：高级接口（需要授权）
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| uid | false | int64 | 好友分组的所有者UID，默认不填为当前登录用户。 |
| 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 | 单页返回的记录条数，默认为50。 |
| page | false | int | 返回结果的页码，默认为1。 |
| base_app | false | int | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
| feature | false | int | 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。 |
注意事项
- 当要查询的分组为私有分组时，当前登录用户必须为分组的所有者；
- 当前登录用户不是指定好友分组的所有者时，只能获取所有人可见的公开分组、和组内成员可见的公开分组（此时当前登录用户必须是组内成员）的微博；
- 最多返回最新300条微博；
调用样例及调试工具
返回结果
JSON示例
{
"statuses": [
"3382905382185354",
"3382905252160340",
"3382905235630562",
...
],
"previous_cursor": 0,
"next_cursor": 0,
"total_number": 16
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
