💎群空间小程序对接

获取配置[开发者阅读]

请求方式

请求地址（GET请求）：

https://baseurl.com/bot/Group/cfg?id={功能ID}_{群聊ID}&edition={版本密钥}

返回信息：

{
"msg": "获取配置信息成功",
"result": {
    "_id": "4be6ffcf6418573500012ef43accc885_34931259041@chatroom",
    "app_id": "4be6ffcf6418573500012ef43accc885",
    "group_id": "34931259041@chatroom",
    "_updateTime": "2023-04-06T11:21:40.261Z",
    "config": {
        "beishuzhi": 100,
        "yiyan": false
        }
    },
"status": 0,
"success": true
}

对接示例

设置模型[管理员阅读]

获取功能ID

功能ID获取方式：即后台的功能文档ID，由管理员生成给插件开发者。

配置菜单

菜单是一个json对象数组，不同类型的配置也不同，具体如下：
建议由管理员设置好name值后发给插件开发者，直接使用即可。
以下配置内容，需删除注释，数组形式保存至后台【功能】菜单的config设置中。
注意：默认值指的是修改设置的时候的默认值，如未使用群空间设置前仍由插件开发者指定。

参数名	中文	必填	解释	示例
type	类型	是	不同类型渲染不同组件，其他参数可能不一致	switch text table picker slider input textarea
name	名字	是	该项配置名字，返回内容中此项为键值，用于区分配置	kaiguan
title	标题	否	配置展示的标题，text类型可不填	开关
value	值	否	默认值，根据不同类型组件传输不同类型，如不填会处理为空、0、false	true
auth	权限	否	可使用该配置的权限，1管理、2超管、3主人，默认为0（即任何可进入管理界面的人）	true
margin	间距	否	和上一个配置是否隔开，可选 top-xs、bottom-xs、tb-xs
placeholder	占位符	否	占位提示语	请选择模式
mode	输入模式	否	文本框专用，可填number、text、digit	请选择模式
picker	选择项	否	单项选择专用，可选项的值，注意，返回值为第几个选项，从0开始	0
max	最大值	否	最大可输入值，输入框值字符长度	0
min	最小值	否	最大可输入值，输入框值字符长度	0
header	表头	否	传入对象数组，表格模式专用，指表头展示内容	[{label: "奖品名",mode: "text",placeholder: "请输入奖品名",prop: "mingzi",width: "300"}]
footer	表尾	否	是否显示表尾合计行，默认为真	true
stripe	斑马纹	否	表格专用，斑马纹样式，默认为真	false
border	间隔边框	否	表格专用，带间隔边框样式，默认为真	false

开关

  {
    "type": "switch", //类型switch
    "name": "enable", //英文，配置项名
    "title": "功能开关",//标题，群空间中展示给用户
    "value": "false",  //默认值
    "margin": "top-xs" //和上方配置隔开
  },

解释文本

  {
    "type": "text",//类型text
    "title": "功能说明",//标题，不填效果也很好
    "value": "平分模式：一段解释文本",
    "margin": true //和上方配置隔开
  },

单项选择

  {
    "type": "picker",//类型picker
    "name": "moshi",//英文，配置项名
    "title": "猜猜模式",//标题
    "picker": [ //文本数组，都有哪些选择
      "倍数",
      "平分"
    ],
    "placeholder": "请选择模式", //占位提示
    "value": "0", //默认值，默认选择哪一条，从0开始
    "margin": "top-xs" //和上方配置隔开
  },

滑动选择器

  {
    "type": "slider",//类型slider
    "name": "beishuzhi",//英文，配置项名
    "title": "倍数值",//标题
    "max": "20",//最大可选值
    "min": "1",//最小可选值
    "value": "3",//默认值
    "margin": "top-xs" //和上方配置隔开
  },

单行输入框

  {
    "type": "input",//类型input
    "mode": "number",//输入模式，number、text、digit
    "name": "menpiao",//英文，配置项名
    "title": "门票",//标题
    "placeholder": "输入门票数量",//占位提示
    "value": "350",//默认值，可选
    "margin": "top-xs" //和上方配置隔开
  },

文本域输入框

  {
    "type": "textarea",//类型textarea
    "name": "weiba",//英文，配置项名
    "title": "门票",//标题
    "placeholder": "回复小尾巴",//占位提示
    "max": "-1",//最大字数，-1或不填为不限制
    "value": "一段比较长的提示文字",//默认值，可选
    "margin": "top-xs" //和上方配置隔开
  },

获取配置[开发者阅读]#

请求方式#

对接示例#

设置模型[管理员阅读]#

获取功能ID#

配置菜单#

开关#

解释文本#

单项选择#

滑动选择器#

单行输入框#

文本域输入框#

效果预览#

获取配置[开发者阅读]

请求方式

对接示例

设置模型[管理员阅读]

获取功能ID

配置菜单

开关

解释文本

单项选择

滑动选择器

单行输入框

文本域输入框

效果预览