Files
sundynix-plant-be/docs/swagger.json
T
2026-02-11 14:33:00 +08:00

4129 lines
130 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"swagger": "2.0",
"info": {
"description": "使用gin + gorm进行极速开发的全栈开发基础平台",
"title": "Swagger API接口文档",
"contact": {},
"version": "v1.0.0"
},
"paths": {
"/auth/captcha": {
"get": {
"produces": [
"application/json"
],
"tags": [
"登录相关"
],
"summary": "获取验证码",
"responses": {
"200": {
"description": "获取验证码",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/response.CaptchaRes"
}
}
}
]
}
}
}
}
},
"/auth/getLocation": {
"get": {
"produces": [
"application/json"
],
"tags": [
"登录相关"
],
"summary": "获取位置信息",
"parameters": [
{
"type": "string",
"description": "longitude",
"name": "longitude",
"in": "query",
"required": true
},
{
"type": "string",
"description": "latitude",
"name": "latitude",
"in": "query",
"required": true
}
],
"responses": {}
}
},
"/auth/getPhone": {
"get": {
"produces": [
"application/json"
],
"tags": [
"登录相关"
],
"summary": "获取手机号",
"parameters": [
{
"type": "string",
"description": "code",
"name": "code",
"in": "query",
"required": true
},
{
"type": "string",
"description": "openId",
"name": "openId",
"in": "query",
"required": true
}
],
"responses": {}
}
},
"/auth/getWeather": {
"get": {
"produces": [
"application/json"
],
"tags": [
"登录相关"
],
"summary": "获取天气信息",
"parameters": [
{
"type": "string",
"description": "adcode",
"name": "adcode",
"in": "query",
"required": true
}
],
"responses": {}
}
},
"/auth/login": {
"post": {
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"登录相关"
],
"summary": "pc登录",
"parameters": [
{
"description": "用户名, 密码, 验证码,验证码id",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.Login"
}
}
],
"responses": {
"200": {
"description": "登录成功",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/auth/logout": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"登录相关"
],
"summary": "pc登出",
"responses": {
"200": {
"description": "登出成功",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/auth/miniLogin": {
"get": {
"produces": [
"application/json"
],
"tags": [
"登录相关"
],
"summary": "小程序登录",
"parameters": [
{
"type": "string",
"description": "code",
"name": "code",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "小程序登录",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/response.LoginResponse"
}
}
}
]
}
}
}
}
},
"/classify/myClassifyLog": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"识别相关"
],
"summary": "我的植物识别记录",
"parameters": [
{
"description": "分页",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.PageInfo"
}
}
],
"responses": {
"200": {
"description": "识别记录",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/classify/plant": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"multipart/form-data"
],
"produces": [
"application/json"
],
"tags": [
"识别相关"
],
"summary": "base64植物识别",
"parameters": [
{
"type": "file",
"description": "植物识别",
"name": "file",
"in": "formData",
"required": true
}
],
"responses": {
"200": {
"description": "文件OCR",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/client/delete": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"客户端管理"
],
"summary": "删除client",
"parameters": [
{
"description": "ids",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.IdsReq"
}
}
],
"responses": {
"200": {
"description": "删除client",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/client/detail": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"description": "id获取详情",
"produces": [
"application/json"
],
"tags": [
"客户端管理"
],
"summary": "获取client详情",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "获取client详情",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/system.Client"
},
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/client/getClientList": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"客户端管理"
],
"summary": "获取client列表",
"parameters": [
{
"description": "client",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.GetClientList"
}
}
],
"responses": {
"200": {
"description": "获取client列表",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/response.PageResult"
},
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/client/save": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"客户端管理"
],
"summary": "创建client",
"parameters": [
{
"description": "client",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/system.Client"
}
}
],
"responses": {
"200": {
"description": "创建client",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/client/update": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"客户端管理"
],
"summary": "更新client",
"parameters": [
{
"description": "client",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/system.Client"
}
}
],
"responses": {
"200": {
"description": "更新client",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/config/level/add": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"等级配置"
],
"summary": "添加等级配置",
"parameters": [
{
"description": "添加等级配置",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.CreateLevelConf"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"添加成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/config/level/detail": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"等级配置"
],
"summary": "等级配置详情",
"parameters": [
{
"type": "string",
"description": "等级配置id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"查询成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/config/level/list": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"等级配置"
],
"summary": "等级配置列表",
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"查询成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/config/level/update": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"等级配置"
],
"summary": "修改等级配置",
"parameters": [
{
"description": "修改等级配置",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.UpdateLevelConf"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"修改成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/menu/delete": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"description": "删除menu",
"produces": [
"application/json"
],
"tags": [
"菜单管理"
],
"summary": "删除menu",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "详情",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/menu/detail": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"description": "id获取详情",
"produces": [
"application/json"
],
"tags": [
"菜单管理"
],
"summary": "获取menu详情",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "详情",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/system.Menu"
},
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/menu/getAllMenuTree": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"菜单管理"
],
"summary": "获取所有菜单树",
"parameters": [
{
"description": "菜单信息",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.GetMenuTree"
}
}
],
"responses": {
"200": {
"description": "获取所有菜单树",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/definitions/system.Menu"
}
},
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/menu/getUserMenuTree": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"菜单管理"
],
"summary": "用户菜单数据",
"responses": {
"200": {
"description": "用户菜单数据",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/definitions/system.Menu"
}
},
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/menu/route": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"菜单管理"
],
"summary": "用户路由",
"responses": {
"200": {
"description": "用户route",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/definitions/system.Menu"
}
},
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/menu/save": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"菜单管理"
],
"summary": "新增菜单",
"parameters": [
{
"description": "menu",
"name": "data",
"in": "body",
"schema": {
"$ref": "#/definitions/system.Menu"
}
}
],
"responses": {
"200": {
"description": "新建菜单/按钮",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/menu/update": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"菜单管理"
],
"summary": "更新菜单",
"parameters": [
{
"description": "menu",
"name": "data",
"in": "body",
"schema": {
"$ref": "#/definitions/system.Menu"
}
}
],
"responses": {
"200": {
"description": "更新菜单",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/oss/delete": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"文件相关"
],
"summary": "删除文件",
"parameters": [
{
"description": "批量删除文件",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.IdsReq"
}
}
],
"responses": {
"200": {
"description": "删除文件",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/oss/detail": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"文件相关"
],
"summary": "文件详情",
"parameters": [
{
"type": "string",
"description": "文件id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "文件详情",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/oss/getFileList": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"文件相关"
],
"summary": "文件列表",
"parameters": [
{
"description": "文件列表",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.GetOssFileList"
}
}
],
"responses": {
"200": {
"description": "文件列表",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/oss/upload": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"multipart/form-data"
],
"produces": [
"application/json"
],
"tags": [
"文件相关"
],
"summary": "文件上传",
"parameters": [
{
"type": "file",
"description": "上传文件",
"name": "file",
"in": "formData",
"required": true
}
],
"responses": {
"200": {
"description": "上传文件",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/plant/add": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "添加植物",
"parameters": [
{
"description": "创建植物",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.CreateMyPlant"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"添加成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/completeTask": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "完成任务",
"parameters": [
{
"description": "完成任务",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.CompleteTask"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"完成任务\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/deletePlan": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "删除任务",
"parameters": [
{
"description": "删除植物",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.IdsReq"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"删除成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/deletePlant": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "删除植物",
"parameters": [
{
"description": "删除植物",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.IdsReq"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"删除成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/detail": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "ById植物详情",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取ById成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/growth/add": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "添加成长记录",
"parameters": [
{
"description": "添加成长记录",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.CreateGrowthRecord"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"添加成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/page": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "植物列表",
"parameters": [
{
"description": "分页获取植物列表",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.PageInfo"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/plan/add": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "添加养护事项",
"parameters": [
{
"description": "添加养护事项",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.CreateCarePlan"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"添加成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/plan/delete": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "删除养护事项",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"删除成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/todayTask": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "今日任务",
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/plant/update": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"我的植物"
],
"summary": "修改ById植物",
"parameters": [
{
"description": "修改ById植物",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.UpdateMyPlant"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"修改ById成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/post/comment": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"帖子"
],
"summary": "评论帖子",
"parameters": [
{
"description": "评论帖子",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.CreateComment"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"评论成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/post/like": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"帖子"
],
"summary": "点赞帖子",
"parameters": [
{
"type": "string",
"description": "帖子id",
"name": "id",
"in": "query",
"required": true
},
{
"type": "string",
"description": "点赞类型 1 点赞 2 取消点赞",
"name": "type",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"点赞成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/post/myPost": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"帖子"
],
"summary": "我的发布",
"parameters": [
{
"description": "分页获取帖子列表",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.PostPage"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/post/page": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"帖子"
],
"summary": "帖子列表",
"parameters": [
{
"description": "分页获取帖子列表",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.PostPage"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/post/publish": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"帖子"
],
"summary": "发布帖子",
"parameters": [
{
"description": "发布帖子",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.CreatePost"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"发布成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/profile/detail": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"个人中心"
],
"summary": "用户详情",
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"查询成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/profile/update": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"个人中心"
],
"summary": "修改用户信息",
"parameters": [
{
"description": "修改用户信息",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.UpdateProfile"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"修改成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/role/delete": {
"post": {
"description": "删除角色",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"角色管理"
],
"summary": "删除角色",
"parameters": [
{
"description": "批量删除角色",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.IdsReq"
}
}
],
"responses": {
"200": {
"description": "删除角色",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/role/detail": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"角色管理"
],
"summary": "角色详情",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "角色详情",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/system.Role"
}
}
}
]
}
}
}
}
},
"/role/getRoleList": {
"post": {
"description": "获取角色列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"角色管理"
],
"summary": "获取角色列表",
"parameters": [
{
"description": "页码, 每页大小, 搜索条件",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.GetRoleList"
}
}
],
"responses": {
"200": {
"description": "获取角色列表,返回包括列表,总数,页码,每页大小",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/response.PageResult"
},
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/role/grantMenu": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"角色管理"
],
"summary": "授权菜单给角色",
"parameters": [
{
"description": "授权菜单给角色",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.GrantMenu"
}
}
],
"responses": {
"200": {
"description": "授权菜单给角色",
"schema": {
"$ref": "#/definitions/response.Response"
}
}
}
}
},
"/role/save": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"角色管理"
],
"summary": "创建角色",
"parameters": [
{
"description": "角色信息",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/system.Role"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/response.Response"
}
}
}
}
},
"/role/update": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"角色管理"
],
"summary": "修改角色",
"parameters": [
{
"description": "角色ID",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/system.Role"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/response.Response"
}
}
}
}
},
"/topic/add": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"帖子话题"
],
"summary": "修改话题",
"parameters": [
{
"description": "修改话题",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.UpdateTopic"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"发布成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/topic/delete": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"帖子话题"
],
"summary": "删除任务",
"parameters": [
{
"description": "删除话题",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.IdsReq"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"删除成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/topic/detail": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"帖子话题"
],
"summary": "话题详情",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/topic/list": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"帖子话题"
],
"summary": "话题列表",
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/topic/page": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"帖子话题"
],
"summary": "话题分页",
"parameters": [
{
"description": "分页获取话题列表",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.PageInfo"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/user/changePassword": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"description": "修改密码",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"用户管理"
],
"summary": "修改密码",
"parameters": [
{
"description": "用户id",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.ChangePwd"
}
}
],
"responses": {
"200": {
"description": "修改密码成功",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/system.User"
}
}
}
]
}
}
}
}
},
"/user/delete": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"用户管理"
],
"summary": "删除用户",
"parameters": [
{
"description": "批量删除用户",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.IdsReq"
}
}
],
"responses": {
"200": {
"description": "删除用户",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/user/detail": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"用户管理"
],
"summary": "获取用户详情",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "获取用户详情成功",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/system.User"
}
}
}
]
}
}
}
}
},
"/user/getUserList": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"用户管理"
],
"summary": "获取用户列表",
"parameters": [
{
"description": "页码, 每页大小, 搜索条件",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.GetUserList"
}
}
],
"responses": {
"200": {
"description": "获取用户列表,返回包括列表,总数,页码,每页大小",
"schema": {
"allOf": [
{
"$ref": "#/definitions/response.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/response.PageResult"
},
"msg": {
"type": "string"
}
}
}
]
}
}
}
}
},
"/user/grantRole": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"用户管理"
],
"summary": "给用户分配角色",
"parameters": [
{
"description": "用户ID, 角色ID",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.GrantRole"
}
}
],
"responses": {
"200": {
"description": "{\"code\": 200, \"data\": [...]}",
"schema": {
"$ref": "#/definitions/response.Response"
}
}
}
}
},
"/user/info": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"用户管理"
],
"summary": "当前登录用户",
"responses": {
"200": {
"description": "{\"code\": 200, \"data\": {}, \"msg\": \"添加成功\"}",
"schema": {
"$ref": "#/definitions/response.Response"
}
}
}
}
},
"/user/save": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"用户管理"
],
"summary": "新增用户",
"parameters": [
{
"description": "用户信息",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/system.User"
}
}
],
"responses": {
"200": {
"description": "{\"code\": 200, \"data\": {}, \"msg\": \"添加成功\"}",
"schema": {
"$ref": "#/definitions/response.Response"
}
}
}
}
},
"/user/update": {
"post": {
"security": [
{
"ApiKeyAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"用户管理"
],
"summary": "更新用户",
"parameters": [
{
"description": "用户ID,用户信息",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/system.User"
}
}
],
"responses": {
"200": {
"description": "{\"code\": 200, \"data\": [...]}",
"schema": {
"$ref": "#/definitions/response.Response"
}
}
}
}
},
"/wiki-class/add": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"百科分类"
],
"summary": "添加分类",
"parameters": [
{
"description": "添加分类",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.CreateWikiClass"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"发布成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/wiki-class/delete": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"百科分类"
],
"summary": "删除分类",
"parameters": [
{
"description": "删除分类",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.IdsReq"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"删除成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/wiki-class/detail": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"百科分类"
],
"summary": "分类详情",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/wiki-class/list": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"百科分类"
],
"summary": "分类列表",
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/wiki-class/page": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"百科分类"
],
"summary": "分类分页",
"parameters": [
{
"description": "分页获取分类列表",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.PageInfo"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/wiki-class/update": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"百科分类"
],
"summary": "修改分类(可直接传入ossId修改图片)",
"parameters": [
{
"description": "修改分类",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.UpdateWikiClass"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"发布成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/wiki/add": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"百科"
],
"summary": "添加百科",
"parameters": [
{
"description": "添加百科",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.CreateWiki"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"发布成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/wiki/detail": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"produces": [
"application/json"
],
"tags": [
"百科"
],
"summary": "百科详情",
"parameters": [
{
"type": "string",
"description": "id",
"name": "id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"获取成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/wiki/page": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"百科"
],
"summary": "分页",
"parameters": [
{
"description": "百科分页",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.WikiPage"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"发布成功\"}",
"schema": {
"type": "string"
}
}
}
}
},
"/wiki/update": {
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"百科"
],
"summary": "修改百科",
"parameters": [
{
"description": "修改百科",
"name": "data",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/request.UpdateWiki"
}
}
],
"responses": {
"200": {
"description": "{\"success\":true,\"data\":{},\"msg\":\"发布成功\"}",
"schema": {
"type": "string"
}
}
}
}
}
},
"definitions": {
"request.CarePlan": {
"type": "object",
"properties": {
"icon": {
"description": "icon信息",
"type": "string"
},
"name": {
"description": "农事名称",
"type": "string"
},
"period": {
"description": "周期",
"type": "integer"
}
}
},
"request.ChangePwd": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"newPwd": {
"type": "string"
}
}
},
"request.CompleteTask": {
"type": "object",
"required": [
"taskId"
],
"properties": {
"remark": {
"type": "string"
},
"taskId": {
"type": "string"
}
}
},
"request.CreateCarePlan": {
"type": "object",
"required": [
"plantId"
],
"properties": {
"icon": {
"description": "icon信息",
"type": "string"
},
"name": {
"description": "农事名称",
"type": "string"
},
"period": {
"description": "周期",
"type": "integer"
},
"plantId": {
"type": "string"
}
}
},
"request.CreateComment": {
"type": "object",
"required": [
"content",
"postId"
],
"properties": {
"content": {
"description": "评论内容",
"type": "string"
},
"postId": {
"description": "帖子id",
"type": "string"
}
}
},
"request.CreateGrowthRecord": {
"type": "object",
"required": [
"plantId"
],
"properties": {
"content": {
"type": "string"
},
"desc": {
"type": "string"
},
"name": {
"type": "string"
},
"ossIds": {
"type": "array",
"items": {
"type": "string"
}
},
"plantId": {
"type": "string"
},
"tag": {
"type": "string"
}
}
},
"request.CreateLevelConf": {
"type": "object",
"properties": {
"level": {
"description": "等级数值",
"type": "integer"
},
"minSunlight": {
"description": "达到该等级所需的最小阳光值",
"type": "integer"
},
"perks": {
"description": "解锁权益描述 (e.g., \"解锁智能诊断\")",
"type": "string"
},
"title": {
"description": "等级称号 (e.g., \"萌芽园丁\")",
"type": "string"
}
}
},
"request.CreateMyPlant": {
"type": "object",
"properties": {
"carePlans": {
"description": "养护计划",
"type": "array",
"items": {
"$ref": "#/definitions/request.CarePlan"
}
},
"name": {
"description": "植物名称",
"type": "string"
},
"ossIds": {
"description": "图片ids",
"type": "array",
"items": {
"type": "string"
}
},
"placement": {
"description": "摆放位置",
"type": "string"
},
"plantTime": {
"description": "种植时间",
"type": "string"
},
"plantingMaterial": {
"description": "植料(即土的材质)",
"type": "string"
},
"potMaterial": {
"description": "花盆材质",
"type": "string"
},
"potSize": {
"description": "花盆大小 如直径 20cm × 高度 18cm",
"type": "string"
},
"sunlight": {
"description": "光照条件如每日12小时",
"type": "string"
}
}
},
"request.CreatePost": {
"type": "object",
"properties": {
"content": {
"description": "内容",
"type": "string"
},
"location": {
"description": "位置",
"type": "string"
},
"ossIds": {
"description": "图片id[]",
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"description": "标题 必须",
"type": "string"
}
}
},
"request.CreateTopic": {
"type": "object",
"properties": {
"end_time": {
"type": "string"
},
"remark": {
"type": "string"
},
"start_time": {
"type": "string"
},
"title": {
"type": "string"
}
}
},
"request.CreateWiki": {
"type": "object",
"required": [
"name"
],
"properties": {
"aliases": {
"description": "别名",
"type": "string"
},
"classIds": {
"description": "分类id",
"type": "array",
"items": {
"type": "string"
}
},
"difficulty": {
"description": "种植难度 1-5级",
"type": "integer"
},
"distributionArea": {
"description": "分布区域",
"type": "string"
},
"flowerDiameter": {
"description": "花直径(cm)",
"type": "integer"
},
"floweringColor": {
"description": "花色",
"type": "string"
},
"floweringPeriod": {
"description": "开花期",
"type": "string"
},
"floweringShape": {
"description": "花形",
"type": "string"
},
"foliageColor": {
"description": "叶色",
"type": "string"
},
"foliageShape": {
"description": "叶形",
"type": "string"
},
"foliageType": {
"description": "叶型",
"type": "string"
},
"fruit": {
"description": "果",
"type": "string"
},
"genus": {
"description": "属",
"type": "string"
},
"growthHabit": {
"description": "生长习性",
"type": "string"
},
"height": {
"description": "高度(cm)",
"type": "integer"
},
"isHot": {
"description": "是否热门",
"type": "integer"
},
"latinName": {
"description": "拉丁名",
"type": "string"
},
"lifeCycle": {
"description": "生命周期",
"type": "string"
},
"lightIntensity": {
"description": "光照强度",
"type": "string"
},
"lightType": {
"description": "光照类型(直射,散射等)",
"type": "string"
},
"name": {
"description": "名称",
"type": "string"
},
"optimalTempPeriod": {
"description": "最佳温度区间",
"type": "string"
},
"ossIds": {
"description": "图片",
"type": "array",
"items": {
"type": "string"
}
},
"pestsDiseases": {
"description": "常见病虫害",
"type": "string"
},
"relatedWikiIds": {
"description": "相关推荐",
"type": "array",
"items": {
"type": "string"
}
},
"reproductionMethod": {
"description": "繁殖方法",
"type": "string"
},
"stem": {
"description": "茎",
"type": "string"
}
}
},
"request.CreateWikiClass": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"description": "分类名称",
"type": "string"
},
"ossId": {
"description": "图片id",
"type": "string"
}
}
},
"request.GetClientList": {
"type": "object",
"properties": {
"clientId": {
"type": "string"
},
"current": {
"description": "页码",
"type": "integer"
},
"keyword": {
"description": "关键字",
"type": "string"
},
"name": {
"type": "string"
},
"pageSize": {
"description": "每页大小",
"type": "integer"
}
}
},
"request.GetMenuTree": {
"type": "object",
"properties": {
"category": {
"type": "integer"
},
"parentId": {
"type": "string"
}
}
},
"request.GetOssFileList": {
"type": "object",
"properties": {
"current": {
"description": "页码",
"type": "integer"
},
"keyword": {
"description": "关键字",
"type": "string"
},
"name": {
"type": "string"
},
"pageSize": {
"description": "每页大小",
"type": "integer"
}
}
},
"request.GetRoleList": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"current": {
"description": "页码",
"type": "integer"
},
"keyword": {
"description": "关键字",
"type": "string"
},
"name": {
"type": "string"
},
"pageSize": {
"description": "每页大小",
"type": "integer"
}
}
},
"request.GetUserList": {
"type": "object",
"properties": {
"account": {
"type": "string"
},
"current": {
"description": "页码",
"type": "integer"
},
"keyword": {
"description": "关键字",
"type": "string"
},
"pageSize": {
"description": "每页大小",
"type": "integer"
},
"phone": {
"type": "string"
}
}
},
"request.GrantMenu": {
"type": "object",
"properties": {
"menuIds": {
"type": "array",
"items": {
"type": "string"
}
},
"roleId": {
"type": "string"
}
}
},
"request.GrantRole": {
"type": "object",
"properties": {
"roleIds": {
"type": "array",
"items": {
"type": "string"
}
},
"userId": {
"type": "string"
}
}
},
"request.IdsReq": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"request.Login": {
"type": "object",
"properties": {
"account": {
"type": "string"
},
"captcha": {
"type": "string"
},
"captchaId": {
"type": "string"
},
"password": {
"type": "string"
}
}
},
"request.PageInfo": {
"type": "object",
"properties": {
"current": {
"description": "页码",
"type": "integer"
},
"keyword": {
"description": "关键字",
"type": "string"
},
"pageSize": {
"description": "每页大小",
"type": "integer"
}
}
},
"request.PostPage": {
"type": "object",
"properties": {
"current": {
"description": "页码",
"type": "integer"
},
"hasReviewed": {
"description": "是否审核通过",
"type": "integer"
},
"keyword": {
"description": "关键字",
"type": "string"
},
"pageSize": {
"description": "每页大小",
"type": "integer"
},
"title": {
"description": "标题",
"type": "string"
}
}
},
"request.UpdateLevelConf": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"level": {
"description": "等级数值",
"type": "integer"
},
"minSunlight": {
"description": "达到该等级所需的最小阳光值",
"type": "integer"
},
"perks": {
"description": "解锁权益描述 (e.g., \"解锁智能诊断\")",
"type": "string"
},
"title": {
"description": "等级称号 (e.g., \"萌芽园丁\")",
"type": "string"
}
}
},
"request.UpdateMyPlant": {
"type": "object",
"required": [
"id"
],
"properties": {
"carePlans": {
"type": "array",
"items": {
"$ref": "#/definitions/request.UpdatePlan"
}
},
"id": {
"type": "string"
},
"name": {
"description": "植物名称",
"type": "string"
},
"placement": {
"description": "摆放位置",
"type": "string"
},
"plantingMaterial": {
"description": "植料(即土的材质)",
"type": "string"
},
"potMaterial": {
"description": "花盆材质",
"type": "string"
},
"potSize": {
"description": "花盆大小 如直径 20cm × 高度 18cm",
"type": "string"
},
"sunlight": {
"description": "光照条件如每日12小时",
"type": "string"
}
}
},
"request.UpdatePlan": {
"type": "object",
"required": [
"id"
],
"properties": {
"icon": {
"description": "icon信息",
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"description": "农事名称",
"type": "string"
},
"period": {
"description": "周期",
"type": "integer"
}
}
},
"request.UpdateProfile": {
"type": "object",
"properties": {
"avatarId": {
"type": "string"
},
"currentSunlight": {
"type": "integer"
},
"levelId": {
"type": "string"
},
"nickname": {
"type": "string"
},
"totalSunlight": {
"type": "integer"
}
}
},
"request.UpdateTopic": {
"type": "object",
"required": [
"id"
],
"properties": {
"end_time": {
"type": "string"
},
"id": {
"type": "integer"
},
"remark": {
"type": "string"
},
"start_time": {
"type": "string"
},
"title": {
"type": "string"
}
}
},
"request.UpdateWiki": {
"type": "object",
"required": [
"id"
],
"properties": {
"aliases": {
"description": "别名",
"type": "string"
},
"difficulty": {
"description": "种植难度 1-5级",
"type": "integer"
},
"distributionArea": {
"description": "分布区域",
"type": "string"
},
"flowerDiameter": {
"description": "花直径(cm)",
"type": "integer"
},
"floweringColor": {
"description": "花色",
"type": "string"
},
"floweringPeriod": {
"description": "开花期",
"type": "string"
},
"floweringShape": {
"description": "花形",
"type": "string"
},
"foliageColor": {
"description": "叶色",
"type": "string"
},
"foliageShape": {
"description": "叶形",
"type": "string"
},
"foliageType": {
"description": "叶型",
"type": "string"
},
"fruit": {
"description": "果",
"type": "string"
},
"genus": {
"description": "属",
"type": "string"
},
"growthHabit": {
"description": "生长习性",
"type": "string"
},
"height": {
"description": "高度(cm)",
"type": "integer"
},
"id": {
"type": "string"
},
"latinName": {
"description": "拉丁名",
"type": "string"
},
"lifeCycle": {
"description": "生命周期",
"type": "string"
},
"lightIntensity": {
"description": "光照强度",
"type": "string"
},
"lightType": {
"description": "光照类型(直射,散射等)",
"type": "string"
},
"name": {
"description": "名称",
"type": "string"
},
"optimalTempPeriod": {
"description": "最佳温度区间",
"type": "string"
},
"pestsDiseases": {
"description": "常见病虫害",
"type": "string"
},
"stem": {
"description": "茎",
"type": "string"
}
}
},
"request.UpdateWikiClass": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"description": "分类名称",
"type": "string"
},
"ossId": {
"description": "图片id",
"type": "string"
}
}
},
"request.WikiPage": {
"type": "object",
"properties": {
"classId": {
"description": "分类id",
"type": "array",
"items": {
"type": "string"
}
},
"current": {
"description": "页码",
"type": "integer"
},
"isHot": {
"description": "是否热门 0否 1是",
"type": "integer"
},
"keyword": {
"description": "关键字",
"type": "string"
},
"name": {
"description": "植物名称",
"type": "string"
},
"pageSize": {
"description": "每页大小",
"type": "integer"
}
}
},
"response.CaptchaRes": {
"type": "object",
"properties": {
"captcha": {
"type": "string"
},
"captchaId": {
"type": "string"
}
}
},
"response.LoginResponse": {
"type": "object",
"properties": {
"expiresAt": {
"type": "integer"
},
"token": {
"type": "string"
},
"user": {
"$ref": "#/definitions/system.User"
}
}
},
"response.PageResult": {
"type": "object",
"properties": {
"list": {},
"page": {
"type": "integer"
},
"pageSize": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"response.Response": {
"type": "object",
"properties": {
"code": {
"type": "integer"
},
"data": {},
"msg": {
"type": "string"
}
}
},
"system.Client": {
"type": "object",
"properties": {
"activeTimeout": {
"type": "integer"
},
"additionalInfo": {
"type": "string"
},
"clientId": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"createdAtStr": {
"type": "string"
},
"grantType": {
"type": "string"
},
"id": {
"description": "主键ID",
"type": "string"
},
"name": {
"type": "string"
},
"updatedAt": {
"type": "string"
}
}
},
"system.Menu": {
"type": "object",
"properties": {
"category": {
"type": "integer"
},
"children": {
"type": "array",
"items": {
"$ref": "#/definitions/system.Menu"
}
},
"code": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"createdAtStr": {
"type": "string"
},
"icon": {
"type": "string"
},
"id": {
"description": "主键ID",
"type": "string"
},
"locale": {
"type": "string"
},
"name": {
"type": "string"
},
"parentId": {
"type": "string"
},
"permission": {
"type": "string"
},
"sort": {
"type": "integer"
},
"title": {
"type": "string"
},
"updatedAt": {
"type": "string"
}
}
},
"system.Oss": {
"type": "object",
"properties": {
"createdAt": {
"type": "string"
},
"createdAtStr": {
"type": "string"
},
"id": {
"description": "主键ID",
"type": "string"
},
"key": {
"type": "string"
},
"md5": {
"type": "string"
},
"name": {
"type": "string"
},
"suffix": {
"type": "string"
},
"tag": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"url": {
"type": "string"
}
}
},
"system.Role": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"createdAtStr": {
"type": "string"
},
"id": {
"description": "主键ID",
"type": "string"
},
"menus": {
"type": "array",
"items": {
"$ref": "#/definitions/system.Menu"
}
},
"name": {
"type": "string"
},
"sort": {
"type": "integer"
},
"updatedAt": {
"type": "string"
}
}
},
"system.User": {
"type": "object",
"properties": {
"account": {
"type": "string"
},
"avatar": {
"$ref": "#/definitions/system.Oss"
},
"avatarId": {
"type": "string"
},
"clientId": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"createdAtStr": {
"type": "string"
},
"id": {
"description": "主键ID",
"type": "string"
},
"miniOpenId": {
"type": "string"
},
"name": {
"type": "string"
},
"nickName": {
"type": "string"
},
"phone": {
"type": "string"
},
"saOpenId": {
"type": "string"
},
"sessionKey": {
"type": "string"
},
"tenantId": {
"type": "string"
},
"unionId": {
"type": "string"
},
"updatedAt": {
"type": "string"
}
}
}
},
"securityDefinitions": {
"BearerAuth": {
"type": "apiKey",
"name": "Authorization",
"in": "header"
}
}
}