(以“{{api_desc_v2| uri=friendships/groups/members/add_batch| desc=批量添加用户到好友分组| httpMethod=POST| needAuth=是| level={{Api_L2}}| rateLimit=是| para...”为内容创建页面) |
|||
| 第13行： | 第13行： | ||
<pre> | <pre> | ||
{ | { | ||
| − | + | "result": false | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
} | } | ||
</pre>| | </pre>| | ||
| 第31行： | 第20行： | ||
*好友分组成员上限为500； | *好友分组成员上限为500； | ||
*当前登录用户必须是该分组的创建者，且只能添加自己关注的人； | *当前登录用户必须是该分组的创建者，且只能添加自己关注的人； | ||
| − | * | + | *返回值result，全部成功和部分成功返回true，全部失败返回false或错误结果；| |
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} | ||
2012年10月24日 (三) 18:02的版本
friendships/groups/members/add_batch
批量添加用户到好友分组
URL
https://api.weibo.com/2/friendships/groups/members/add_batch.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：高级接口（需要授权）
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| list_id | true | int64 | 好友分组ID，建议使用返回值里的idstr。 |
| uids | true | string | 需要添加的用户的UID，多个之间用逗号分隔，最多不超过30个。 |
| group_descriptions | false | string | 添加成员的分组说明，每个说明最多8个汉字，16个半角字符，多个需先URLencode，然后再用半角逗号分隔，最多不超过30个，且需与uids参数一一对应。 |
注意事项
- 好友分组成员上限为500；
- 当前登录用户必须是该分组的创建者，且只能添加自己关注的人；
- 返回值result，全部成功和部分成功返回true，全部失败返回false或错误结果；
调用样例及调试工具
返回结果
JSON示例
{
"result": false
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
