(创建新页面为 '{{api_desc_v2| uri=friendships/groups/create| desc=创建好友分组| httpMethod=POST| needAuth=是| level={{Api_L2}}| rateLimit=是| params= {{api_args|name|true|string|要创…') |
|||
| 第7行： | 第7行： | ||
rateLimit=是| | rateLimit=是| | ||
params= | params= | ||
| − | {{api_args|name|true|string|要创建的好友分组的名称，不超过10个汉字，20个半角字符。}}| | + | {{api_args|name|true|string|要创建的好友分组的名称，不超过10个汉字，20个半角字符。}} |
| + | {{api_args|description|false|string|要创建的好友分组的描述，不超过70个汉字，140个半角字符。}} | ||
| + | {{api_args|tags|false|string|要创建的好友分组的标签，多个之间用逗号分隔，最多不超过10个，每个不超过7个汉字，14个半角字符。}} | ||
| + | {{api_args|mode|false|string|好友分组的私有属性，private：私有分组（分组及成员仅自己可见）、public：公开分组（分组所有人可见，成员可见性由参数visible设置），默认为private。}} | ||
| + | {{api_args|visible|false|int|好友分组成员的可见范围，当且仅当参数mode为public时有效，0：组内成员可见、1：所有人可见，默认为0。}}| | ||
result= | result= | ||
<pre> | <pre> | ||
{ | { | ||
| − | "id": | + | "id": 3404979794629010, |
| − | "idstr": " | + | "idstr": "3404979794629010", |
| − | "name": " | + | "name": "同事", |
| + | "mode": "private", | ||
| + | "visible": 0, | ||
| + | "like_count": 0, | ||
| + | "member_count": 0, | ||
| + | "description": "", | ||
| + | "tags": [], | ||
| + | "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1", | ||
| + | "user": { | ||
| + | "id": 1404376560, | ||
| + | "idstr": "1404376560", | ||
| + | "screen_name": "zaku", | ||
| + | "name": "zaku", | ||
| + | "province": "11", | ||
| + | "city": "5", | ||
| + | "location": "北京 朝阳区", | ||
| + | "description": "微博开放平台产品。人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。", | ||
| + | "url": "http://blog.sina.com.cn/zaku", | ||
| + | "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1", | ||
| + | "profile_url": "zaku", | ||
| + | "domain": "zaku", | ||
| + | "weihao": "", | ||
| + | "gender": "m", | ||
| + | "followers_count": 1440, | ||
| + | "friends_count": 604, | ||
| + | "statuses_count": 3543, | ||
| + | "favourites_count": 14, | ||
| + | "created_at": "Fri Aug 28 00:00:00 +0800 2009", | ||
| + | "following": false, | ||
| + | "allow_all_act_msg": false, | ||
| + | "geo_enabled": true, | ||
| + | "verified": false, | ||
| + | "verified_type": -1, | ||
| + | "status_id": 3453143964431400, | ||
| + | "allow_all_comment": true, | ||
| + | "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/5629870687/1", | ||
| + | "verified_reason": "", | ||
| + | "follow_me": false, | ||
| + | "online_status": 0, | ||
| + | "bi_followers_count": 286, | ||
| + | "lang": "zh-cn" | ||
| + | }, | ||
| + | "created_at": "Mon Jan 23 12:45:05 +0800 2012" | ||
} | } | ||
</pre>| | </pre>| | ||
resultDes=无| | resultDes=无| | ||
useAge= | useAge= | ||
| + | *每个用户最多能够创建20个好友分组； | ||
*重复创建同名分组将给出错误； | *重复创建同名分组将给出错误； | ||
| − | *用户自己创建的分组，相互之间名称不能重复；| | + | *用户自己创建的分组，相互之间名称不能重复； |
| + | *好友分组在创建时默认为私有分组，即分组及成员仅创建者自己可见； | ||
| + | *创建好友分组时，可指定创建为公开分组，分组为所有人可见，其成员是否可见由visible参数指定； | ||
| + | *参数visible，设置好友分组成员可见性，分为组内成员可见、所有人可见；| | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} | ||
2012年6月4日 (一) 11:39的版本
friendships/groups/create
创建好友分组
URL
https://api.weibo.com/2/friendships/groups/create.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：高级接口（需要授权）
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| name | true | string | 要创建的好友分组的名称，不超过10个汉字，20个半角字符。 |
| description | false | string | 要创建的好友分组的描述，不超过70个汉字，140个半角字符。 |
| tags | false | string | 要创建的好友分组的标签，多个之间用逗号分隔，最多不超过10个，每个不超过7个汉字，14个半角字符。 |
| mode | false | string | 好友分组的私有属性，private：私有分组（分组及成员仅自己可见）、public：公开分组（分组所有人可见，成员可见性由参数visible设置），默认为private。 |
| visible | false | int | 好友分组成员的可见范围，当且仅当参数mode为public时有效，0：组内成员可见、1：所有人可见，默认为0。 |
注意事项
- 每个用户最多能够创建20个好友分组；
- 重复创建同名分组将给出错误；
- 用户自己创建的分组，相互之间名称不能重复；
- 好友分组在创建时默认为私有分组，即分组及成员仅创建者自己可见；
- 创建好友分组时，可指定创建为公开分组，分组为所有人可见，其成员是否可见由visible参数指定；
- 参数visible，设置好友分组成员可见性，分为组内成员可见、所有人可见；
调用样例及调试工具
返回结果
JSON示例
{
"id": 3404979794629010,
"idstr": "3404979794629010",
"name": "同事",
"mode": "private",
"visible": 0,
"like_count": 0,
"member_count": 0,
"description": "",
"tags": [],
"profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1",
"user": {
"id": 1404376560,
"idstr": "1404376560",
"screen_name": "zaku",
"name": "zaku",
"province": "11",
"city": "5",
"location": "北京 朝阳区",
"description": "微博开放平台产品。人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
"url": "http://blog.sina.com.cn/zaku",
"profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1",
"profile_url": "zaku",
"domain": "zaku",
"weihao": "",
"gender": "m",
"followers_count": 1440,
"friends_count": 604,
"statuses_count": 3543,
"favourites_count": 14,
"created_at": "Fri Aug 28 00:00:00 +0800 2009",
"following": false,
"allow_all_act_msg": false,
"geo_enabled": true,
"verified": false,
"verified_type": -1,
"status_id": 3453143964431400,
"allow_all_comment": true,
"avatar_large": "http://tp1.sinaimg.cn/1404376560/180/5629870687/1",
"verified_reason": "",
"follow_me": false,
"online_status": 0,
"bi_followers_count": 286,
"lang": "zh-cn"
},
"created_at": "Mon Jan 23 12:45:05 +0800 2012"
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
