设置进群问候语&群公告
收藏接口说明
本接口可用于设置进群问候语，群公告配置。
使用限制
- •需要用户授权，授权用户需为粉丝群群主身份
- •仅支持粉丝群类型的群聊
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/im/group/setting/set/ |
| HTTP Method | POST |
| Scope | im.group_fans.create_list |
| 权限要求 | 小程序私信/群管理 满足任一能力即可 粉丝群管理 满足任一能力即可 |
请求参数
请求头
access-token必填String
示例：bus_act.1d1021d2aee3d41fee2d2adfwdf56badMFZnrhFhfWotu3Ecuiuka27L56lr
content-type必填String
固定值"application/json"
Query
open_id必填String
示例：ba253642-0590-40bc-9bdf-9a1334b94059
Body展开全部子属性
group_id必填String
粉丝群 ID
group_setting_typeEnum
群管理配置类型
展开子属性
msg_listList
欢迎语支持
- •同时设置文本 + 小程序引导卡片
- •同时设置文本 + 小程序券
群公告只支持设置文本
展开子属性
请求示例
curl -X POST 'https://open.douyin.com//im/group/setting/set/?open_id=_000xzRQpcoxD3BxBa8gh_pSqhCts9e7W5Of' -H 'Content-Type:application/json' -H 'access-token:act.3.twcMj968gNlk10bQxejCFptAgy7xz14cpuNplMTCt4PKnO8_K2pzgTfWh6PuCI9iBuUBrMxmc357OI_9zz-BP2ypsGC1giKiQEyzWiRSc48Vk_mh3Q_yJJjKInJslCnbzUPBP7k3LHM-mw-4M2yDwbQNROIvpQOs8o_DK96ZnEUj9xfXqQk1oZy_I48=' --data ' { "group_setting_type":1, "group_id":"@4F8C16DLBMpoayH0MI44GaX+1WSGOvqKMpZ2rgigLVAab/b033bhf2Iujgn96zUFzrEMFkG/vUKhYHQ90PrjsQ==", "msg_list":[ { "msg_type":1, "text":{ "text":"66666" } }, { "msg_type":10, "applet_card":{ "card_template_id":"@4F8C16DLB+1WSGO/yAA61JkTKeF2ltKgvvhATKtvrScVZhhxZ/", "schema":"https://z.douyin.com/lktwYRo", "app_id":"ttfa398c06e94401" } } ] }'
响应参数
Body
err_msg必填String
err_no必填Int32
log_id必填String
响应示例
{ "err_no": 28001007, "err_msg": "invalid text, contains url pattern", "log_id": "202405202301116F2D6D2E84AC0F262D2C" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 28001005 | 系统内部错误，请重试 | 请求重试，若依然无解请向平台提交反馈 |
| 200 | 28001003 | access_token无效 | 重新请求生成access_token |
| 200 | 28001008 | access_token过期,请刷新或重新授权 | 重新请求生成access_token |
| 200 | 28001016 | 当前应用已被封禁或下线 | clientKey被封禁或者下线 |
| 200 | 28001006 | 网络调用错误，请重试 | 重试即可 |
| 200 | 28001014 | 应用未授权任何能力 | 确认应用是否授权能力 |
| 200 | 28001018 | 应用未获得该能力 | 开通相关能力 |
| 200 | 28003017 | quota已用完 | 联系平台处理 |
| 200 | 28001019 | 应用该能力已被封禁 | 该能力被封禁，联系平台处理 |
| 200 | 28001007 | 参数不合法 | 根据错误信息检查请求参数是否填写正常 |
