💎群空间小程序对接
获取配置[开发者阅读]
请求方式
请求地址(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" //和上方配置隔开
},
效果预览
最后修改时间: 5 个月前