创建粉丝群
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/im/group/fans/create/
接口说明
注意事项
| 群类型 | 数据类型 | 枚举值 | 建群条件 |
|---|---|---|---|
| 主播粉丝群 | int | 2 | 需要用户通过实名认证 需要用户有开播纪录 |
| 万粉群 | int | 5 | 需要用户粉丝量过万 |
| 粉丝群等级等级权益 | 开通条件 |
|---|---|
| Lv.1 可创建10个粉丝群 | 粉丝数量>1w |
| Lv.2 可创建20个粉丝群 | 以下条件满足其一： 粉丝数量>10w 月日均gmv>=2000 累计群人数>2000且近7天累计群发言人数>20人 |
| Lv.3 可创建40个粉丝群 | 以下条件满足其一： 粉丝数量>100w 月日均gmv>=10000 累计群人数>4000且近7天累计群发言人数>30人 |
| Lv.4 可创建100个粉丝群 | 以下条件满足其一： 群人数>10000 近7天累计群发言人数>100人 群主发消息条数>20条 |
权限要求
错误码
请求参数
Query 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/im/group/fans/create/?open_id=123-4567-890' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"avatar_uri":"https://xxx",
"group_name":"创建群",
"description":"创建群",
"open_audit_switch":1,
"show_at_profile":1,
"live_auto_sync":1,
"item_auto_sync":1
}'响应示例响应示例
{
"extra": {
"description": "",
"sub_error_code": 0,
"sub_description": "",
"now": 1648797449,
"logid": "021648797449846fd1b1111000700600000000000000086dfb920",
"error_code": 0
},
"data": {
"error_code": 0,
"description": ""
},
"group_id": "aaaaaaa"
}
修改于 2025-11-07 09:36:54