# 建立群活码(平台号)
请求方式:POST
请求地址:https://$basehost/gateway/qopen/CreateGroupActiveCode
body参数:
{
"ac_task_name": "",
"ac_title": "",
"group_id_list": ["群id"],
"max_group_member_num": 40,
"is_auto_create_group": true,
"robot_id_list": ["机器人id"],
"contact_id_list": ["创建新群被拉企业成员id"],
"group_name": "",
"group_init_num": 1
}
参数说明
参数 | 参数类型 | 必填 | 说明 |
---|---|---|---|
ac_task_name | string | 是 | 群活码任务名(不超过20个字符) |
ac_title | string | 是 | 群活码标题 (不超过20个字符) |
group_id_list | array | 是 | 群id列表(不超过200) |
max_group_member_num | int | 是 | 群人数上限(50~200) |
is_auto_create_group | boolean | 否 | 是否群满自动拉新群(默认否) |
robot_id_list | array | 否 | 机器人id(不超过30) |
contact_id_list | array | 否 | 创建群被拉企业成员id(不超过30) |
group_name | string | 否 | 群聊名称(不超过15个字符) |
group_init_num | int | 否 | 拉新群初始编号 |
返回值:
{
"data": {
"ac_url": "群活码二维码url",
"real_ac_url": "群活码链接",
"str_open_id": "群活码id"
},
"errcode":0,
"errmsg": "",
"hint": ""
}
返回参数说明
参数 | 参数类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
ac_url | string | 群活码二维码url |
real_ac_url | string | 群活码链接 |
str_open_id | string | 群活码id |
hint | string | 请求日志ID |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/CreateGroupActiveCode \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"ac_task_name": "",
"ac_title": "",
"group_id_list": ["群id"],
"max_group_member_num": 40,
"is_auto_create_group": true,
"robot_id_list": ["机器人id"],
"contact_id_list": ["创建新群被拉企业成员id"],
"group_name": "",
"group_init_num": 1
}'