跳转到: 导航, 搜索

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参数一一对应。

注意事项

  • 好友分组成员上限为200;
  • 当前登录用户必须是该分组的创建者,且只能添加自己关注的人;
  • 返回值result,全部成功和部分成功返回true,全部失败返回false或错误结果;

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "result": false
}

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

返回字段说明

其他

相关问题


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


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




api评价