跳转到: 导航, 搜索
第1行: 第1行:
 
{{api_desc_v2|
 
{{api_desc_v2|
 
uri=friendships/groups/timeline/ids|
 
uri=friendships/groups/timeline/ids|
desc=获取某一好友分组的微博ID列表|
+
desc=获取当前登陆用户某一好友分组的微博ID列表|
 
httpMethod=GET|
 
httpMethod=GET|
 
needAuth=是|
 
needAuth=是|
第7行: 第7行:
 
rateLimit=是|
 
rateLimit=是|
 
params=
 
params=
{{api_args|uid|false|int64|好友分组的所有者UID,默认不填为当前登录用户。}}
 
 
{{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。}}
第19行: 第18行:
 
{
 
{
 
     "statuses": [
 
     "statuses": [
         "3382905382185354",
+
         "3474117204484620",
         "3382905252160340",
+
         "3474097403402005",
         "3382905235630562",
+
         "3474064524259699",
 +
        "3474037357630386",
 +
        "3474014649113676",
 
         ...
 
         ...
 
     ],
 
     ],
 +
    "hasvisible": false,
 
     "previous_cursor": 0,
 
     "previous_cursor": 0,
     "next_cursor": 0,
+
     "next_cursor": 3473996207153375,
     "total_number": 16
+
     "total_number": 2000
 
}
 
}
 
</pre>|
 
</pre>|
 
resultDes=无|
 
resultDes=无|
 
useAge=
 
useAge=
*当要查询的分组为私有分组时,当前登录用户必须为分组的所有者;
+
*当前登录用户不是指定好友分组的所有者时,只能获取所有人可见的公开分组、和组内成员可见的公开分组(此时当前登录用户必须是组内成员)的微博;
+
|
*最多返回最新300条微博;|
+
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

2012年10月24日 (三) 14:24的版本

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授权后获得。
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。

注意事项

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "statuses": [
        "3474117204484620",
        "3474097403402005",
        "3474064524259699",
        "3474037357630386",
        "3474014649113676",
        ...
    ],
    "hasvisible": false,
    "previous_cursor": 0,
    "next_cursor": 3473996207153375,
    "total_number": 2000
}

关于错误返回值与错误代码,参见 错误代码说明

返回字段说明

其他

相关问题

{{{relat_qa}}}


帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




api评价