(创建新页面为 '{{api_desc_v2| uri=friendships/groups/listed| desc=批量获取某个用户在当前用户的好友分组中的分组信息| httpMethod=GET| needAuth=是| level={{Api_L2}}| rate…') |
|||
| 第1行： | 第1行： | ||
{{api_desc_v2| | {{api_desc_v2| | ||
uri=friendships/groups/listed| | uri=friendships/groups/listed| | ||
| − | desc= | + | desc=批量获取某些用户在指定用户的好友分组中的收录信息| |
httpMethod=GET| | httpMethod=GET| | ||
needAuth=是| | needAuth=是| | ||
| 第7行： | 第7行： | ||
rateLimit=是| | rateLimit=是| | ||
params= | params= | ||
| − | {{api_args|uids|true|string|需要获取好友分组信息的用户UID列表，多个之间用逗号分隔，每次不超过50个。}}| | + | {{api_args|uids|true|string|需要获取好友分组信息的用户UID列表，多个之间用逗号分隔，每次不超过50个。}} |
| + | {{api_args|owner_uid|false|int64|需要查询的好友分组所有者的UID，默认不填为当前登录用户。}}| | ||
result= | result= | ||
<pre> | <pre> | ||
| 第17行： | 第18行： | ||
"id": 201101270045006180, | "id": 201101270045006180, | ||
"idstr": "201101270045006191", | "idstr": "201101270045006191", | ||
| − | "name": "同学" | + | "name": "同学", |
| + | "mode": "public", | ||
| + | "visible": 0 | ||
}, | }, | ||
... | ... | ||
| 第26行： | 第29行： | ||
</pre>| | </pre>| | ||
resultDes=无| | resultDes=无| | ||
| − | useAge= | + | useAge= |
| + | *当要查询的分组为私有分组时，当前登录用户必须为分组的所有者； | ||
| + | *返回的查询结果，是当前登录用户可以看到的公开分组的查询结果；| | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} | ||
2012年5月31日 (四) 16:37的版本
friendships/groups/listed
批量获取某些用户在指定用户的好友分组中的收录信息
URL
https://api.weibo.com/2/friendships/groups/listed.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：高级接口（需要授权）
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| uids | true | string | 需要获取好友分组信息的用户UID列表，多个之间用逗号分隔，每次不超过50个。 |
| owner_uid | false | int64 | 需要查询的好友分组所有者的UID，默认不填为当前登录用户。 |
注意事项
- 当要查询的分组为私有分组时，当前登录用户必须为分组的所有者；
- 返回的查询结果，是当前登录用户可以看到的公开分组的查询结果；
调用样例及调试工具
返回结果
JSON示例
[
{
"uid": "1706926301",
"lists": [
{
"id": 201101270045006180,
"idstr": "201101270045006191",
"name": "同学",
"mode": "public",
"visible": 0
},
...
]
},
...
]
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
