zfc/bindbox-game
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
bindbox-game/docs/swagger.json
邹方成 1ab39d2f5a
Some checks failed
Build docker and publish / linux (1.24.5) (push) Failing after 25s
Details
refactor: 重构项目结构并重命名模块 
feat(admin): 新增工会管理功能
feat(activity): 添加活动管理相关服务
feat(user): 实现用户道具卡和积分管理
feat(guild): 新增工会成员管理功能

fix: 修复数据库连接配置
fix: 修正jwtoken导入路径
fix: 解决端口冲突问题

style: 统一代码格式和注释风格
style: 更新项目常量命名

docs: 添加项目框架和开发规范文档
docs: 更新接口文档注释

chore: 移除无用代码和文件
chore: 更新Makefile和配置文件
chore: 清理日志文件

test: 添加道具卡测试脚本
2025-11-14 21:10:00 +08:00

6510 lines
210 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": {
"title": "mini-chat 接口文档",
"contact": {},
"version": "v0.0.1"
},
"basePath": "/",
"paths": {
"/api/admin/activities": {
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "创建活动，配置基本信息与分类、Boss标签",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "创建活动",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.createActivityRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessageResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/activities/{activity_id}": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定活动的详细信息",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "查看活动详情",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/model.Activities"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"put": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "修改活动基本信息、分类、Boss标签等",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "修改活动",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.modifyActivityRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessageResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"delete": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "删除指定活动",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "删除活动",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessageResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/activities/{activity_id}/issues": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "获取指定活动的期数列表，支持分页",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "查看活动期数",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listIssuesResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "为指定活动创建一个新的期数",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "创建活动期数",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.createIssueRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessage"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/activities/{activity_id}/issues/{issue_id}": {
"put": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "修改指定期数的信息",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "修改活动期数",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "期ID",
"name": "issue_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.modifyIssueRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessage"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"delete": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "删除指定期数",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "删除活动期数",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "期ID",
"name": "issue_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessage"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/activities/{activity_id}/issues/{issue_id}/rewards": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定期数的奖励配置列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "查看期数奖品",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "期ID",
"name": "issue_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listRewardsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "为指定期数批量创建奖励配置",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "创建期数奖品",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "期ID",
"name": "issue_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.createRewardsRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessageResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/activities/{activity_id}/issues/{issue_id}/rewards/{reward_id}": {
"put": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "更新期数奖励",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "期ID",
"name": "issue_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "奖励ID",
"name": "reward_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.modifyRewardRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessageResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"delete": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "删除期数奖励",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "期ID",
"name": "issue_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "奖励ID",
"name": "reward_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessageResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/activity_categories": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "获取启用状态的活动分类列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.活动"
],
"summary": "活动分类列表",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listCategoriesResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/banners": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.运营"
],
"summary": "查看轮播图列表",
"parameters": [
{
"type": "integer",
"description": "状态",
"name": "status",
"in": "query"
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listBannersResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.运营"
],
"summary": "创建轮播图",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.createBannerRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.createBannerResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/banners/{banner_id}": {
"put": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.运营"
],
"summary": "修改轮播图",
"parameters": [
{
"type": "string",
"description": "轮播图ID",
"name": "banner_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.modifyBannerRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.pcSimpleMessage"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"delete": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.运营"
],
"summary": "删除轮播图",
"parameters": [
{
"type": "string",
"description": "轮播图ID",
"name": "banner_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.pcSimpleMessage"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/create": {
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "新增客服",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.客服管理"
],
"summary": "新增客服",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.createAdminRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.createAdminResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/delete": {
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "删除客服",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.客服管理"
],
"summary": "删除客服",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.deleteAdminRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.deleteAdminResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/guilds": {
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "创建工会并将首位成员设为会长",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.工会"
],
"summary": "创建工会",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.createGuildRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.createGuildResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/guilds/{guild_id}": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定工会详情",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.工会"
],
"summary": "查看工会详情",
"parameters": [
{
"type": "integer",
"description": "工会ID",
"name": "guild_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/model.Guild"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"put": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "修改指定工会信息",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.工会"
],
"summary": "修改工会",
"parameters": [
{
"type": "integer",
"description": "工会ID",
"name": "guild_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.modifyGuildRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.modifyGuildResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"delete": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "删除指定工会",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.工会"
],
"summary": "删除工会",
"parameters": [
{
"type": "integer",
"description": "工会ID",
"name": "guild_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.deleteGuildResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/guilds/{guild_id}/members": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定工会的成员列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.工会"
],
"summary": "查看工会成员",
"parameters": [
{
"type": "integer",
"description": "工会ID",
"name": "guild_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listGuildMembersResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/list": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "客服列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.客服管理"
],
"summary": "客服列表",
"parameters": [
{
"type": "string",
"description": "用户名",
"name": "username",
"in": "query"
},
{
"type": "string",
"description": "昵称",
"name": "nickname",
"in": "query"
},
{
"type": "integer",
"default": 1,
"description": "当前页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页返回的数据量，最多 100 条",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/login": {
"post": {
"description": "管理员登录",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.登录"
],
"summary": "管理员登录",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.loginRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.loginResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/product_categories": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.商品"
],
"summary": "查看商品分类列表",
"parameters": [
{
"type": "string",
"description": "名称",
"name": "name",
"in": "query"
},
{
"type": "integer",
"description": "状态",
"name": "status",
"in": "query"
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listProductCategoriesResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.商品"
],
"summary": "创建商品分类",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.createProductCategoryRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.createProductCategoryResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/product_categories/{category_id}": {
"put": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.商品"
],
"summary": "修改商品分类",
"parameters": [
{
"type": "string",
"description": "分类ID",
"name": "category_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.modifyProductCategoryRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.pcSimpleMessage"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"delete": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.商品"
],
"summary": "删除商品分类",
"parameters": [
{
"type": "string",
"description": "分类ID",
"name": "category_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.pcSimpleMessage"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/products": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.商品"
],
"summary": "查看商品列表",
"parameters": [
{
"type": "string",
"description": "名称",
"name": "name",
"in": "query"
},
{
"type": "integer",
"description": "分类ID",
"name": "category_id",
"in": "query"
},
{
"type": "integer",
"description": "状态",
"name": "status",
"in": "query"
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listProductsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.商品"
],
"summary": "创建商品",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.createProductRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.createProductResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/products/{product_id}": {
"put": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.商品"
],
"summary": "修改商品",
"parameters": [
{
"type": "string",
"description": "商品ID",
"name": "product_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.modifyProductRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.pcSimpleMessage"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"delete": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.商品"
],
"summary": "删除商品",
"parameters": [
{
"type": "string",
"description": "商品ID",
"name": "product_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.pcSimpleMessage"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/system_item_cards": {
"get": {
"description": "管理员获取道具卡列表，支持按名称、状态、类型等条件筛选",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.运营管理"
],
"summary": "获取道具卡列表",
"parameters": [
{
"type": "string",
"description": "道具卡名称",
"name": "name",
"in": "query"
},
{
"type": "integer",
"description": "状态：1启用 2禁用",
"name": "status",
"in": "query"
},
{
"type": "integer",
"description": "道具卡类型：1抽奖卡 2加成卡 3保底卡",
"name": "card_type",
"in": "query"
},
{
"type": "integer",
"description": "适用范围：1全局 2活动分类 3活动 4期次",
"name": "scope_type",
"in": "query"
},
{
"type": "integer",
"description": "页码，默认1",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "每页条数，默认10",
"name": "page_size",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listItemCardsResponse"
}
},
"400": {
"description": "参数错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"401": {
"description": "未授权",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"500": {
"description": "服务器内部错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"post": {
"description": "管理员创建新的道具卡，支持设置类型、效果、有效期等属性",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.运营管理"
],
"summary": "创建道具卡",
"parameters": [
{
"description": "创建道具卡请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.createItemCardRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.createItemCardResponse"
}
},
"400": {
"description": "参数错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"401": {
"description": "未授权",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"403": {
"description": "无权限，仅超管可操作",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"500": {
"description": "服务器内部错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/system_item_cards/{item_card_id}": {
"put": {
"description": "管理员修改道具卡信息，支持修改名称、价格、有效期等属性",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.运营管理"
],
"summary": "修改道具卡",
"parameters": [
{
"type": "integer",
"description": "道具卡ID",
"name": "item_card_id",
"in": "path",
"required": true
},
{
"description": "修改道具卡请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.modifyItemCardRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessageResponse"
}
},
"400": {
"description": "参数错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"401": {
"description": "未授权",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"403": {
"description": "无权限，仅超管可操作",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"500": {
"description": "服务器内部错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"delete": {
"description": "管理员删除指定的道具卡",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.运营管理"
],
"summary": "删除道具卡",
"parameters": [
{
"type": "integer",
"description": "道具卡ID",
"name": "item_card_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessageResponse"
}
},
"400": {
"description": "参数错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"401": {
"description": "未授权",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"403": {
"description": "无权限，仅超管可操作",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"500": {
"description": "服务器内部错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看APP端用户分页列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "管理端用户列表",
"parameters": [
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listUsersResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/coupons": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定用户持有的优惠券列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "查看用户优惠券列表",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listCouponsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/coupons/add": {
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "管理端为指定用户发放优惠券",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "给用户添加优惠券",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.addCouponRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.addCouponResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/inventory": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定用户的资产记录",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "查看用户资产列表",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listInventoryResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/invites": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定用户邀请的用户列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "查看用户邀请列表",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listInvitesResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/item_cards": {
"post": {
"description": "管理员给指定用户分配道具卡，可指定数量",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.运营管理"
],
"summary": "给用户分配道具卡",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"description": "分配道具卡请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.assignItemCardRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.simpleMessageResponse"
}
},
"400": {
"description": "参数错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"401": {
"description": "未授权",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"403": {
"description": "无权限，仅超管可操作",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"500": {
"description": "服务器内部错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/orders": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定用户的订单记录",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "查看用户订单列表",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listOrdersResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/points": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定用户的积分流水记录",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "查看用户积分记录",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.listPointsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/points/add": {
"post": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "管理端为指定用户发放积分，支持设置有效期",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "给用户添加积分",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.addPointsRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.addPointsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/points/balance": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "查看指定用户当前积分余额（过滤过期）",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "查看用户积分余额",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.pointsBalanceResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/users/{user_id}/rewards/grant": {
"post": {
"description": "管理员给用户发放奖励，支持实物和虚拟奖品，可选择关联活动和奖励配置",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.用户"
],
"summary": "给用户发放奖励",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.GrantRewardRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.GrantRewardResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"403": {
"description": "Forbidden",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"500": {
"description": "Internal Server Error",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/admin/{id}": {
"put": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "编辑客服",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.客服管理"
],
"summary": "编辑客服",
"parameters": [
{
"type": "string",
"description": "编号ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/admin.modifyAdminRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.modifyAdminResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/activities": {
"get": {
"description": "获取活动列表，支持分类、Boss、状态过滤与分页",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.活动"
],
"summary": "活动列表",
"parameters": [
{
"type": "string",
"description": "活动名称(模糊)",
"name": "name",
"in": "query"
},
{
"type": "integer",
"description": "活动分类ID",
"name": "category_id",
"in": "query"
},
{
"type": "integer",
"description": "是否Boss(0/1)",
"name": "is_boss",
"in": "query"
},
{
"type": "integer",
"description": "状态(1进行中 2下线)",
"name": "status",
"in": "query"
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listActivitiesResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/activities/{activity_id}": {
"get": {
"description": "获取指定活动的详细信息",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.活动"
],
"summary": "活动详情",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/model.Activities"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/activities/{activity_id}/issues": {
"get": {
"description": "获取指定活动的期列表，支持分页",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.活动"
],
"summary": "活动期列表",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listIssuesResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/activities/{activity_id}/issues/{issue_id}/draw_logs": {
"get": {
"description": "查看指定活动期数的抽奖记录，支持分页",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.活动"
],
"summary": "抽奖记录列表",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "期ID",
"name": "issue_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listDrawLogsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/activities/{activity_id}/issues/{issue_id}/rewards": {
"get": {
"description": "获取指定期的奖励配置列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.活动"
],
"summary": "奖励配置列表",
"parameters": [
{
"type": "integer",
"description": "活动ID",
"name": "activity_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "期ID",
"name": "issue_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listRewardsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/banners": {
"get": {
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.运营"
],
"summary": "APP端轮播图列表",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listAppBannersResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/guilds": {
"get": {
"description": "获取工会列表，支持公开与状态过滤以及分页",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.工会"
],
"summary": "浏览工会列表",
"parameters": [
{
"type": "string",
"description": "工会名称(模糊)",
"name": "name",
"in": "query"
},
{
"type": "integer",
"description": "是否公开(1公开 2私有)",
"name": "is_open",
"in": "query"
},
{
"type": "integer",
"description": "状态(1正常 2解散)",
"name": "status",
"in": "query"
},
{
"type": "integer",
"description": "加入方式(1审核 2自动 3消费流水)",
"name": "join_mode",
"in": "query"
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listGuildsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/guilds/{guild_id}": {
"get": {
"description": "查看指定工会详情",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.工会"
],
"summary": "查看工会详情",
"parameters": [
{
"type": "integer",
"description": "工会ID",
"name": "guild_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/model.Guild"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/guilds/{guild_id}/members": {
"get": {
"description": "查看指定工会的成员列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.工会"
],
"summary": "查看工会成员",
"parameters": [
{
"type": "integer",
"description": "工会ID",
"name": "guild_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listMembersResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
},
"post": {
"description": "用户加入指定工会",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.工会"
],
"summary": "加入工会",
"parameters": [
{
"type": "integer",
"description": "工会ID",
"name": "guild_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/app.joinGuildRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.simpleMessageResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/guilds/{guild_id}/members/{user_id}": {
"delete": {
"description": "用户离开指定工会",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.工会"
],
"summary": "离开工会",
"parameters": [
{
"type": "integer",
"description": "工会ID",
"name": "guild_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.simpleMessageResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/phone/login": {
"post": {
"description": "使用手机号登录，沿用 code 字段承载手机号或手机号授权码",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "手机号登录",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/app.phoneLoginRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.phoneLoginResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/weixin/login": {
"post": {
"description": "微信静默登录（需传递 code；可选 invite_code）",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "微信登录",
"parameters": [
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/app.weixinLoginRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.weixinLoginResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/{user_id}": {
"put": {
"description": "修改用户昵称与头像",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "修改用户信息",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/app.modifyUserRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.modifyUserResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/{user_id}/coupons": {
"get": {
"description": "查看用户持有的优惠券列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "查看用户优惠券",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listCouponsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/{user_id}/invites": {
"get": {
"description": "查看被该用户邀请的用户列表",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "查看用户邀请记录",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listInvitesResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/{user_id}/item_cards": {
"get": {
"description": "获取指定用户的道具卡列表，支持分页",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "获取用户道具卡列表",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "页码，默认1",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "每页条数，默认10",
"name": "page_size",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listUserItemCardsResponse"
}
},
"400": {
"description": "参数错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"401": {
"description": "未授权",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"500": {
"description": "服务器内部错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/{user_id}/item_cards/uses": {
"get": {
"description": "获取指定用户的道具卡使用记录，支持分页",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "获取用户道具卡使用记录",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "页码，默认1",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "每页条数，默认10",
"name": "page_size",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listUserItemCardUsesResponse"
}
},
"400": {
"description": "参数错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"401": {
"description": "未授权",
"schema": {
"$ref": "#/definitions/code.Failure"
}
},
"500": {
"description": "服务器内部错误",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/{user_id}/orders": {
"get": {
"description": "查看用户抽奖来源订单记录",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "查看用户订单记录",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listOrdersResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/{user_id}/phone/bind": {
"post": {
"description": "使用微信手机号 code 换取手机号并绑定到指定用户",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "绑定手机号",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"description": "请求参数",
"name": "RequestBody",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/app.bindPhoneRequest"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.bindPhoneResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/{user_id}/points": {
"get": {
"description": "查看用户积分流水记录",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "查看用户积分记录",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
},
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "page",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量，最多100",
"name": "page_size",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.listPointsResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/app/users/{user_id}/points/balance": {
"get": {
"description": "查看用户积分余额（过滤过期积分）",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"APP端.用户"
],
"summary": "查看用户积分余额",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "user_id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/app.pointsBalanceResponse"
}
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/definitions/code.Failure"
}
}
}
}
},
"/api/role/list": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.系统"
],
"summary": "角色列表",
"parameters": [
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "current",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量",
"name": "size",
"in": "query",
"required": true
},
{
"type": "string",
"description": "角色名称",
"name": "roleName",
"in": "query"
},
{
"type": "string",
"description": "角色编码",
"name": "roleCode",
"in": "query"
},
{
"type": "boolean",
"description": "是否启用",
"name": "enabled",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.roleListResponse"
}
}
}
}
},
"/api/user/list": {
"get": {
"security": [
{
"LoginVerifyToken": []
}
],
"description": "返回系统用户分页数据",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"管理端.系统"
],
"summary": "系统用户列表",
"parameters": [
{
"type": "integer",
"default": 1,
"description": "页码",
"name": "current",
"in": "query",
"required": true
},
{
"type": "integer",
"default": 20,
"description": "每页数量",
"name": "size",
"in": "query",
"required": true
},
{
"type": "string",
"description": "用户名",
"name": "userName",
"in": "query"
},
{
"type": "string",
"description": "邮箱",
"name": "userEmail",
"in": "query"
},
{
"type": "string",
"description": "手机号",
"name": "userPhone",
"in": "query"
},
{
"type": "string",
"description": "状态",
"name": "status",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/admin.userListResponse"
}
}
}
}
},
"/api/v3/system/menus/simple": {
"get": {
"responses": {}
}
}
},
"definitions": {
"admin.GrantRewardRequest": {
"type": "object",
"required": [
"product_id"
],
"properties": {
"activity_id": {
"description": "活动ID（可选）",
"type": "integer"
},
"address_id": {
"description": "收货地址ID（可选，实物商品需要）",
"type": "integer"
},
"product_id": {
"description": "商品ID",
"type": "integer"
},
"quantity": {
"description": "发放数量",
"type": "integer",
"minimum": 1
},
"remark": {
"description": "备注",
"type": "string"
},
"reward_id": {
"description": "奖励配置ID（可选）",
"type": "integer"
}
}
},
"admin.GrantRewardResponse": {
"type": "object",
"properties": {
"inventory_ids": {
"type": "array",
"items": {
"type": "integer"
}
},
"message": {
"type": "string"
},
"order_id": {
"type": "integer"
},
"success": {
"type": "boolean"
}
}
},
"admin.activitysvcIssueData": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"issue_number": {
"type": "string"
},
"sort": {
"type": "integer"
},
"status": {
"type": "integer"
}
}
},
"admin.addCouponRequest": {
"type": "object",
"required": [
"coupon_id"
],
"properties": {
"coupon_id": {
"type": "integer"
}
}
},
"admin.addCouponResponse": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
}
}
},
"admin.addPointsRequest": {
"type": "object",
"required": [
"points"
],
"properties": {
"kind": {
"type": "string"
},
"points": {
"type": "integer"
},
"remark": {
"type": "string"
},
"valid_days": {
"type": "integer"
}
}
},
"admin.addPointsResponse": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
}
}
},
"admin.adminUserCouponItem": {
"type": "object",
"properties": {
"coupon_id": {
"type": "integer"
},
"discount_type": {
"type": "integer"
},
"discount_value": {
"type": "integer"
},
"id": {
"type": "integer"
},
"min_spend": {
"type": "integer"
},
"name": {
"type": "string"
},
"scope_type": {
"type": "integer"
},
"status": {
"type": "integer"
},
"used_at": {
"type": "string"
},
"used_order_id": {
"type": "integer"
},
"valid_end": {
"type": "string"
},
"valid_start": {
"type": "string"
}
}
},
"admin.adminUserItem": {
"type": "object",
"properties": {
"avatar": {
"type": "string"
},
"created_at": {
"type": "string"
},
"id": {
"type": "integer"
},
"invite_code": {
"type": "string"
},
"inviter_id": {
"type": "integer"
},
"nickname": {
"type": "string"
}
}
},
"admin.assignItemCardRequest": {
"type": "object",
"required": [
"card_id"
],
"properties": {
"card_id": {
"type": "integer"
},
"quantity": {
"type": "integer"
}
}
},
"admin.bannerItem": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"image_url": {
"type": "string"
},
"link_url": {
"type": "string"
},
"sort": {
"type": "integer"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
}
}
},
"admin.categoryItem": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
}
},
"admin.createActivityRequest": {
"type": "object",
"required": [
"activity_category_id",
"name"
],
"properties": {
"activity_category_id": {
"type": "integer"
},
"banner": {
"type": "string"
},
"end_time": {
"type": "string"
},
"is_boss": {
"type": "integer"
},
"name": {
"type": "string"
},
"price_draw": {
"type": "integer"
},
"start_time": {
"type": "string"
},
"status": {
"type": "integer"
}
}
},
"admin.createAdminRequest": {
"type": "object",
"required": [
"nickname",
"password",
"username"
],
"properties": {
"avatar": {
"description": "头像",
"type": "string"
},
"mobile": {
"description": "手机号",
"type": "string"
},
"nickname": {
"description": "昵称",
"type": "string"
},
"password": {
"description": "密码",
"type": "string"
},
"username": {
"description": "用户名",
"type": "string"
}
}
},
"admin.createAdminResponse": {
"type": "object",
"properties": {
"message": {
"description": "提示信息",
"type": "string"
}
}
},
"admin.createBannerRequest": {
"type": "object",
"required": [
"image_url",
"title"
],
"properties": {
"image_url": {
"type": "string"
},
"link_url": {
"type": "string"
},
"sort": {
"type": "integer"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
}
}
},
"admin.createBannerResponse": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"message": {
"type": "string"
}
}
},
"admin.createGuildRequest": {
"type": "object",
"required": [
"name",
"owner_id"
],
"properties": {
"avatar_url": {
"type": "string"
},
"consume_limit": {
"type": "integer"
},
"description": {
"type": "string"
},
"is_open": {
"type": "integer"
},
"join_mode": {
"type": "integer"
},
"name": {
"type": "string"
},
"owner_id": {
"type": "integer"
}
}
},
"admin.createGuildResponse": {
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
},
"admin.createIssueRequest": {
"type": "object",
"required": [
"issue_number"
],
"properties": {
"issue_number": {
"type": "string"
},
"sort": {
"type": "integer"
},
"status": {
"type": "integer"
}
}
},
"admin.createItemCardRequest": {
"type": "object",
"required": [
"card_type",
"effect_type",
"name",
"price",
"scope_type"
],
"properties": {
"activity_category_id": {
"type": "integer"
},
"activity_id": {
"type": "integer"
},
"boost_rate_x1000": {
"type": "integer"
},
"card_type": {
"type": "integer"
},
"effect_type": {
"type": "integer"
},
"issue_id": {
"type": "integer"
},
"max_effect_value_x1000": {
"type": "integer"
},
"name": {
"type": "string"
},
"price": {
"type": "integer"
},
"remark": {
"type": "string"
},
"reward_multiplier_x1000": {
"type": "integer"
},
"scope_type": {
"type": "integer"
},
"stacking_strategy": {
"type": "integer"
},
"status": {
"type": "integer"
},
"valid_end_unix": {
"type": "integer"
},
"valid_start_unix": {
"type": "integer"
}
}
},
"admin.createItemCardResponse": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"message": {
"type": "string"
}
}
},
"admin.createProductCategoryRequest": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"parent_id": {
"type": "integer"
},
"status": {
"type": "integer"
}
}
},
"admin.createProductCategoryResponse": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"message": {
"type": "string"
}
}
},
"admin.createProductRequest": {
"type": "object",
"required": [
"category_id",
"name",
"price",
"stock"
],
"properties": {
"category_id": {
"type": "integer"
},
"images_json": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"type": "integer"
},
"status": {
"type": "integer"
},
"stock": {
"type": "integer"
}
}
},
"admin.createProductResponse": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"message": {
"type": "string"
}
}
},
"admin.createRewardsRequest": {
"type": "object",
"required": [
"rewards"
],
"properties": {
"rewards": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.rewardItem"
}
}
}
},
"admin.deleteAdminRequest": {
"type": "object",
"required": [
"ids"
],
"properties": {
"ids": {
"description": "编号(多个用,分割)",
"type": "string"
}
}
},
"admin.deleteAdminResponse": {
"type": "object",
"properties": {
"message": {
"description": "提示信息",
"type": "string"
}
}
},
"admin.deleteGuildResponse": {
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
},
"admin.itemCardListItem": {
"type": "object",
"properties": {
"activity_category_id": {
"description": "指定活动分类ID（可空）",
"type": "integer"
},
"activity_id": {
"description": "指定活动ID（可空）",
"type": "integer"
},
"boost_rate_x1000": {
"description": "概率提升（千分比，+20%=200）",
"type": "integer"
},
"card_type": {
"description": "卡类型：1双倍奖励 2概率提升 等",
"type": "integer"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"effect_type": {
"description": "效果类型：1奖励倍数 2概率提升 等",
"type": "integer"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"issue_id": {
"description": "指定期ID（可空）",
"type": "integer"
},
"max_effect_value_x1000": {
"description": "效果上限（千分比）",
"type": "integer"
},
"name": {
"description": "卡名称",
"type": "string"
},
"price": {
"description": "售卖价格（分）",
"type": "integer"
},
"remark": {
"description": "备注",
"type": "string"
},
"reward_multiplier_x1000": {
"description": "奖励倍数（千分比，×2=2000）",
"type": "integer"
},
"scope_type": {
"description": "适用范围：1全局 2活动分类 3活动 4期",
"type": "integer"
},
"stacking_strategy": {
"description": "叠加策略：1禁止 2同类叠加-上限 3取最大值 4乘法叠加",
"type": "integer"
},
"status": {
"description": "状态：1启用 2停用",
"type": "integer"
},
"updated_at": {
"description": "更新时间",
"type": "string"
},
"valid_end": {
"description": "有效期结束",
"type": "string"
},
"valid_start": {
"description": "有效期开始",
"type": "string"
}
}
},
"admin.listBannersResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.bannerItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listCategoriesResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.categoryItem"
}
}
}
},
"admin.listCouponsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.adminUserCouponItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listData": {
"type": "object",
"properties": {
"avatar": {
"description": "头像",
"type": "string"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"id": {
"description": "编号",
"type": "integer"
},
"mobile": {
"description": "手机号",
"type": "string"
},
"nickname": {
"description": "昵称",
"type": "string"
},
"updated_at": {
"description": "更新时间",
"type": "string"
},
"username": {
"description": "用户名",
"type": "string"
}
}
},
"admin.listGuildMembersResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.memberItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listInventoryResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/user.InventoryWithProduct"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listInvitesResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.adminUserItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listIssuesResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.activitysvcIssueData"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listItemCardsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.itemCardListItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listOrdersResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/user.OrderWithItems"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listPointsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/model.UserPointsLedger"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listProductCategoriesResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.productCategoryListItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listProductsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.productItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.listResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.listData"
}
},
"page": {
"description": "当前页码",
"type": "integer"
},
"page_size": {
"description": "每页返回的数据量",
"type": "integer"
},
"total": {
"description": "符合查询条件的总记录数",
"type": "integer"
}
}
},
"admin.listRewardsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.rewardItem"
}
}
}
},
"admin.listUsersResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.adminUserItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.loginRequest": {
"type": "object",
"required": [
"password",
"username"
],
"properties": {
"password": {
"description": "密码 (MD5加密后的密码)",
"type": "string"
},
"username": {
"description": "用户名",
"type": "string"
}
}
},
"admin.loginResponse": {
"type": "object",
"properties": {
"is_super": {
"description": "是否是超级管理员(1:是 0:否)",
"type": "integer"
},
"token": {
"description": "登录成功后颁发的 Token",
"type": "string"
}
}
},
"admin.memberItem": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"role": {
"type": "string"
},
"start_time": {
"type": "string"
},
"user_id": {
"type": "integer"
}
}
},
"admin.modifyActivityRequest": {
"type": "object",
"properties": {
"activity_category_id": {
"type": "integer"
},
"banner": {
"type": "string"
},
"end_time": {
"type": "string"
},
"is_boss": {
"type": "integer"
},
"name": {
"type": "string"
},
"price_draw": {
"type": "integer"
},
"start_time": {
"type": "string"
},
"status": {
"type": "integer"
}
}
},
"admin.modifyAdminRequest": {
"type": "object",
"required": [
"nickname",
"username"
],
"properties": {
"avatar": {
"description": "头像",
"type": "string"
},
"mobile": {
"description": "手机号",
"type": "string"
},
"nickname": {
"description": "昵称",
"type": "string"
},
"password": {
"description": "密码",
"type": "string"
},
"username": {
"description": "用户名",
"type": "string"
}
}
},
"admin.modifyAdminResponse": {
"type": "object",
"properties": {
"message": {
"description": "提示信息",
"type": "string"
}
}
},
"admin.modifyBannerRequest": {
"type": "object",
"properties": {
"image_url": {
"type": "string"
},
"link_url": {
"type": "string"
},
"sort": {
"type": "integer"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
}
}
},
"admin.modifyGuildRequest": {
"type": "object",
"properties": {
"avatar_url": {
"type": "string"
},
"consume_limit": {
"type": "integer"
},
"description": {
"type": "string"
},
"is_open": {
"type": "integer"
},
"join_mode": {
"type": "integer"
},
"name": {
"type": "string"
},
"status": {
"type": "integer"
}
}
},
"admin.modifyGuildResponse": {
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
},
"admin.modifyIssueRequest": {
"type": "object",
"properties": {
"issue_number": {
"type": "string"
},
"sort": {
"type": "integer"
},
"status": {
"type": "integer"
}
}
},
"admin.modifyItemCardRequest": {
"type": "object",
"properties": {
"activity_category_id": {
"type": "integer"
},
"activity_id": {
"type": "integer"
},
"boost_rate_x1000": {
"type": "integer"
},
"card_type": {
"type": "integer"
},
"effect_type": {
"type": "integer"
},
"issue_id": {
"type": "integer"
},
"max_effect_value_x1000": {
"type": "integer"
},
"name": {
"type": "string"
},
"price": {
"type": "integer"
},
"remark": {
"type": "string"
},
"reward_multiplier_x1000": {
"type": "integer"
},
"scope_type": {
"type": "integer"
},
"stacking_strategy": {
"type": "integer"
},
"status": {
"type": "integer"
},
"valid_end_unix": {
"type": "integer"
},
"valid_start_unix": {
"type": "integer"
}
}
},
"admin.modifyProductCategoryRequest": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"parent_id": {
"type": "integer"
},
"status": {
"type": "integer"
}
}
},
"admin.modifyProductRequest": {
"type": "object",
"properties": {
"category_id": {
"type": "integer"
},
"images_json": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"type": "integer"
},
"status": {
"type": "integer"
},
"stock": {
"type": "integer"
}
}
},
"admin.modifyRewardRequest": {
"type": "object",
"properties": {
"is_boss": {
"type": "integer"
},
"level": {
"type": "integer"
},
"name": {
"type": "string"
},
"original_qty": {
"type": "integer"
},
"product_id": {
"type": "integer"
},
"quantity": {
"type": "integer"
},
"sort": {
"type": "integer"
},
"weight": {
"type": "integer"
}
}
},
"admin.pcSimpleMessage": {
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
},
"admin.pointsBalanceResponse": {
"type": "object",
"properties": {
"balance": {
"type": "integer"
}
}
},
"admin.productCategoryListItem": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"parent_id": {
"type": "integer"
},
"status": {
"type": "integer"
}
}
},
"admin.productItem": {
"type": "object",
"properties": {
"category_id": {
"type": "integer"
},
"id": {
"type": "integer"
},
"images_json": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"type": "integer"
},
"sales": {
"type": "integer"
},
"status": {
"type": "integer"
},
"stock": {
"type": "integer"
}
}
},
"admin.rewardItem": {
"type": "object",
"required": [
"level",
"name",
"original_qty",
"quantity",
"weight"
],
"properties": {
"id": {
"type": "integer"
},
"is_boss": {
"type": "integer"
},
"level": {
"type": "integer"
},
"name": {
"type": "string"
},
"original_qty": {
"type": "integer"
},
"product_id": {
"type": "integer"
},
"quantity": {
"type": "integer"
},
"sort": {
"type": "integer"
},
"weight": {
"type": "integer"
}
}
},
"admin.roleItem": {
"type": "object",
"properties": {
"createTime": {
"type": "string"
},
"description": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"roleCode": {
"type": "string"
},
"roleId": {
"type": "integer"
},
"roleName": {
"type": "string"
}
}
},
"admin.roleListResponse": {
"type": "object",
"properties": {
"current": {
"type": "integer"
},
"records": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.roleItem"
}
},
"size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"admin.simpleMessage": {
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
},
"admin.simpleMessageResponse": {
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
},
"admin.userListItem": {
"type": "object",
"properties": {
"avatar": {
"type": "string"
},
"createBy": {
"type": "string"
},
"createTime": {
"type": "string"
},
"id": {
"type": "integer"
},
"nickName": {
"type": "string"
},
"status": {
"type": "string"
},
"updateBy": {
"type": "string"
},
"updateTime": {
"type": "string"
},
"userEmail": {
"type": "string"
},
"userGender": {
"type": "string"
},
"userName": {
"type": "string"
},
"userPhone": {
"type": "string"
},
"userRoles": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"admin.userListResponse": {
"type": "object",
"properties": {
"current": {
"type": "integer"
},
"records": {
"type": "array",
"items": {
"$ref": "#/definitions/admin.userListItem"
}
},
"size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.activityItem": {
"type": "object",
"properties": {
"activity_category_id": {
"type": "integer"
},
"banner": {
"type": "string"
},
"category_name": {
"type": "string"
},
"id": {
"type": "integer"
},
"is_boss": {
"type": "integer"
},
"name": {
"type": "string"
},
"price_draw": {
"type": "integer"
},
"status": {
"type": "integer"
}
}
},
"app.appBannerItem": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"image_url": {
"type": "string"
},
"link_url": {
"type": "string"
},
"sort": {
"type": "integer"
},
"title": {
"type": "string"
}
}
},
"app.bindPhoneRequest": {
"type": "object",
"properties": {
"code": {
"type": "string"
}
}
},
"app.bindPhoneResponse": {
"type": "object",
"properties": {
"mobile": {
"type": "string"
},
"success": {
"type": "boolean"
}
}
},
"app.drawLogItem": {
"type": "object",
"properties": {
"current_level": {
"type": "integer"
},
"id": {
"type": "integer"
},
"is_winner": {
"type": "integer"
},
"issue_id": {
"type": "integer"
},
"level": {
"type": "integer"
},
"order_id": {
"type": "integer"
},
"reward_id": {
"type": "integer"
},
"user_id": {
"type": "integer"
}
}
},
"app.guildItem": {
"type": "object",
"properties": {
"avatar_url": {
"type": "string"
},
"consume_limit": {
"type": "integer"
},
"description": {
"type": "string"
},
"id": {
"type": "integer"
},
"is_open": {
"type": "integer"
},
"join_mode": {
"type": "integer"
},
"name": {
"type": "string"
},
"owner_id": {
"type": "integer"
},
"status": {
"type": "integer"
}
}
},
"app.inviteUserItem": {
"type": "object",
"properties": {
"avatar": {
"type": "string"
},
"id": {
"type": "integer"
},
"invite_code": {
"type": "string"
},
"nickname": {
"type": "string"
}
}
},
"app.issueItem": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"issue_number": {
"type": "string"
},
"sort": {
"type": "integer"
},
"status": {
"type": "integer"
}
}
},
"app.joinGuildRequest": {
"type": "object",
"required": [
"user_id"
],
"properties": {
"user_id": {
"type": "integer"
}
}
},
"app.listActivitiesResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/app.activityItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listAppBannersResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/app.appBannerItem"
}
}
}
},
"app.listCouponsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/model.UserCoupons"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listDrawLogsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/app.drawLogItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listGuildsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/app.guildItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listInvitesResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/app.inviteUserItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listIssuesResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/app.issueItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listMembersResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/app.memberItem"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listOrdersResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/model.Orders"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listPointsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/model.UserPointsLedger"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listRewardsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/app.rewardItem"
}
}
}
},
"app.listUserItemCardUsesResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/model.ActivityDrawEffects"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.listUserItemCardsResponse": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"$ref": "#/definitions/model.UserItemCards"
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
},
"app.memberItem": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"role": {
"type": "string"
},
"start_time": {
"type": "string"
},
"user_id": {
"type": "integer"
}
}
},
"app.modifyUserRequest": {
"type": "object",
"properties": {
"avatar": {
"type": "string"
},
"nickname": {
"type": "string"
}
}
},
"app.modifyUserResponse": {
"type": "object",
"properties": {
"user": {
"$ref": "#/definitions/app.userItem"
}
}
},
"app.phoneLoginRequest": {
"type": "object",
"properties": {
"code": {
"description": "兼容参数名：这里作为手机号或第三方手机号code",
"type": "string"
},
"invite_code": {
"type": "string"
}
}
},
"app.phoneLoginResponse": {
"type": "object",
"properties": {
"avatar": {
"type": "string"
},
"invite_code": {
"type": "string"
},
"nickname": {
"type": "string"
},
"user_id": {
"type": "integer"
}
}
},
"app.pointsBalanceResponse": {
"type": "object",
"properties": {
"balance": {
"type": "integer"
}
}
},
"app.rewardItem": {
"type": "object",
"properties": {
"is_boss": {
"type": "integer"
},
"level": {
"type": "integer"
},
"name": {
"type": "string"
},
"original_qty": {
"type": "integer"
},
"product_id": {
"type": "integer"
},
"quantity": {
"type": "integer"
},
"sort": {
"type": "integer"
},
"weight": {
"type": "integer"
}
}
},
"app.simpleMessageResponse": {
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
},
"app.userItem": {
"type": "object",
"properties": {
"avatar": {
"type": "string"
},
"id": {
"type": "integer"
},
"invite_code": {
"type": "string"
},
"inviter_id": {
"type": "integer"
},
"nickname": {
"type": "string"
}
}
},
"app.weixinLoginRequest": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"invite_code": {
"type": "string"
}
}
},
"app.weixinLoginResponse": {
"type": "object",
"properties": {
"avatar": {
"type": "string"
},
"invite_code": {
"type": "string"
},
"nickname": {
"type": "string"
},
"user_id": {
"type": "integer"
}
}
},
"code.Failure": {
"type": "object",
"properties": {
"code": {
"description": "业务码",
"type": "integer"
},
"message": {
"description": "描述信息",
"type": "string"
}
}
},
"model.Activities": {
"type": "object",
"properties": {
"activity_category_id": {
"description": "活动所属分类ID（activity_categories.id，可空）",
"type": "integer"
},
"banner": {
"description": "活动横幅/海报URL",
"type": "string"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"end_time": {
"description": "结束时间",
"type": "string"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"is_boss": {
"description": "Boss: 1 是 0 不是",
"type": "integer"
},
"name": {
"description": "活动名称",
"type": "string"
},
"price_draw": {
"description": "活动门票价格",
"type": "integer"
},
"start_time": {
"description": "开始时间",
"type": "string"
},
"status": {
"description": "状态：1进行中 2下线",
"type": "integer"
},
"updated_at": {
"description": "更新时间",
"type": "string"
}
}
},
"model.ActivityDrawEffects": {
"type": "object",
"properties": {
"activity_category_id": {
"description": "范围快照-活动分类ID",
"type": "integer"
},
"activity_id": {
"description": "范围快照-活动ID",
"type": "integer"
},
"applied": {
"description": "是否生效：0否 1是",
"type": "integer"
},
"card_type": {
"description": "卡类型快照",
"type": "integer"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"draw_log_id": {
"description": "抽奖日志ID（activity_draw_logs.id）",
"type": "integer"
},
"effect_type": {
"description": "效果类型快照",
"type": "integer"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"issue_id": {
"description": "范围快照-期ID",
"type": "integer"
},
"probability_delta_x1000": {
"description": "概率相对增益（千分比）",
"type": "integer"
},
"remark": {
"description": "备注",
"type": "string"
},
"reward_multiplier_x1000": {
"description": "奖励倍数（千分比）",
"type": "integer"
},
"scope_type": {
"description": "适用范围快照",
"type": "integer"
},
"system_item_card_id": {
"description": "卡模板ID（system_item_cards.id）",
"type": "integer"
},
"user_id": {
"description": "用户ID（users.id）",
"type": "integer"
},
"user_item_card_id": {
"description": "用户卡实例ID（user_item_cards.id）",
"type": "integer"
}
}
},
"model.Guild": {
"type": "object",
"properties": {
"avatar_url": {
"description": "工会头像",
"type": "string"
},
"consume_limit": {
"description": "加入工会消费流水最低限额(分)",
"type": "integer"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"description": {
"description": "工会描述",
"type": "string"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"is_open": {
"description": "1 公开 2 私有",
"type": "integer"
},
"join_mode": {
"description": "加入方式 1: 审核通过 2: 自动通过 3. 消费流水",
"type": "integer"
},
"name": {
"description": "公会名称",
"type": "string"
},
"owner_id": {
"description": "会长用户ID",
"type": "integer"
},
"status": {
"description": "状态：1正常 2解散",
"type": "integer"
}
}
},
"model.OrderItems": {
"type": "object",
"properties": {
"created_at": {
"description": "创建时间",
"type": "string"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"order_id": {
"description": "订单ID（orders.id）",
"type": "integer"
},
"price": {
"description": "成交单价（分）",
"type": "integer"
},
"product_id": {
"description": "商品ID（products.id）",
"type": "integer"
},
"product_images": {
"description": "商品图片快照（JSON）",
"type": "string"
},
"quantity": {
"description": "购买数量",
"type": "integer"
},
"status": {
"description": "行状态：1正常 2取消",
"type": "integer"
},
"title": {
"description": "商品标题快照",
"type": "string"
},
"total_amount": {
"description": "行应付总额（分）",
"type": "integer"
}
}
},
"model.Orders": {
"type": "object",
"properties": {
"actual_amount": {
"description": "实际支付金额（分）",
"type": "integer"
},
"cancelled_at": {
"description": "取消时间",
"type": "string"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"discount_amount": {
"description": "优惠券抵扣金额（分）",
"type": "integer"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"is_consumed": {
"description": "是否已履约/消耗（对虚拟资产）",
"type": "integer"
},
"order_no": {
"description": "业务订单号（唯一）",
"type": "string"
},
"paid_at": {
"description": "支付完成时间",
"type": "string"
},
"pay_preorder_id": {
"description": "关联预支付单ID（payment_preorder.id）",
"type": "integer"
},
"points_amount": {
"description": "积分抵扣金额（分）",
"type": "integer"
},
"points_ledger_id": {
"description": "积分扣减流水ID（user_points_ledger.id）",
"type": "integer"
},
"remark": {
"description": "备注",
"type": "string"
},
"source_type": {
"description": "来源：1商城直购 2抽奖票据 3其他",
"type": "integer"
},
"status": {
"description": "订单状态：1待支付 2已支付 3已取消 4已退款",
"type": "integer"
},
"total_amount": {
"description": "订单总金额（分）",
"type": "integer"
},
"updated_at": {
"description": "更新时间",
"type": "string"
},
"user_address_id": {
"description": "收货地址ID（user_addresses.id）",
"type": "integer"
},
"user_id": {
"description": "下单用户ID（user_members.id）",
"type": "integer"
}
}
},
"model.UserCoupons": {
"type": "object",
"properties": {
"coupon_id": {
"description": "券模板ID（system_coupons.id）",
"type": "integer"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"status": {
"description": "状态：1未使用 2已使用 3已过期",
"type": "integer"
},
"updated_at": {
"description": "更新时间",
"type": "string"
},
"used_at": {
"description": "核销时间",
"type": "string"
},
"used_order_id": {
"description": "核销的订单ID（orders.id）",
"type": "integer"
},
"user_id": {
"description": "用户ID（user_members.id）",
"type": "integer"
},
"valid_end": {
"description": "有效期结束",
"type": "string"
},
"valid_start": {
"description": "有效期开始",
"type": "string"
}
}
},
"model.UserItemCards": {
"type": "object",
"properties": {
"card_id": {
"description": "卡模板ID（system_item_cards.id）",
"type": "integer"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"remark": {
"description": "备注",
"type": "string"
},
"status": {
"description": "状态：1未使用 2已使用 3已过期",
"type": "integer"
},
"updated_at": {
"description": "更新时间",
"type": "string"
},
"used_activity_id": {
"description": "使用时活动ID",
"type": "integer"
},
"used_at": {
"description": "使用时间",
"type": "string"
},
"used_draw_log_id": {
"description": "使用关联抽奖日志ID（activity_draw_logs.id）",
"type": "integer"
},
"used_issue_id": {
"description": "使用时期ID",
"type": "integer"
},
"user_id": {
"description": "用户ID（users.id）",
"type": "integer"
},
"valid_end": {
"description": "有效期结束",
"type": "string"
},
"valid_start": {
"description": "有效期开始",
"type": "string"
}
}
},
"model.UserPointsLedger": {
"type": "object",
"properties": {
"action": {
"description": "变更动作：signin/order_deduct/refund_restore/manual",
"type": "string"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"points": {
"description": "积分变动值（正增负减）",
"type": "integer"
},
"ref_id": {
"description": "关联ID（如订单号/记录ID）",
"type": "string"
},
"ref_table": {
"description": "关联表名（如orders/payment_refund）",
"type": "string"
},
"remark": {
"description": "备注",
"type": "string"
},
"user_id": {
"description": "用户ID（user_members.id）",
"type": "integer"
}
}
},
"user.InventoryWithProduct": {
"type": "object",
"properties": {
"activity_id": {
"description": "来源活动ID",
"type": "integer"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"order_id": {
"description": "来源订单ID",
"type": "integer"
},
"product_id": {
"description": "资产对应商品ID（实物奖/商品）",
"type": "integer"
},
"product_images": {
"type": "string"
},
"product_name": {
"type": "string"
},
"remark": {
"description": "备注",
"type": "string"
},
"reward_id": {
"description": "来源奖励ID（activity_reward_settings.id）",
"type": "integer"
},
"status": {
"description": "状态：1持有 2作废 3已使用/发货",
"type": "integer"
},
"updated_at": {
"description": "更新时间",
"type": "string"
},
"user_id": {
"description": "资产归属用户ID",
"type": "integer"
}
}
},
"user.OrderWithItems": {
"type": "object",
"properties": {
"actual_amount": {
"description": "实际支付金额（分）",
"type": "integer"
},
"cancelled_at": {
"description": "取消时间",
"type": "string"
},
"created_at": {
"description": "创建时间",
"type": "string"
},
"discount_amount": {
"description": "优惠券抵扣金额（分）",
"type": "integer"
},
"id": {
"description": "主键ID",
"type": "integer"
},
"is_consumed": {
"description": "是否已履约/消耗（对虚拟资产）",
"type": "integer"
},
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/model.OrderItems"
}
},
"order_no": {
"description": "业务订单号（唯一）",
"type": "string"
},
"paid_at": {
"description": "支付完成时间",
"type": "string"
},
"pay_preorder_id": {
"description": "关联预支付单ID（payment_preorder.id）",
"type": "integer"
},
"points_amount": {
"description": "积分抵扣金额（分）",
"type": "integer"
},
"points_ledger_id": {
"description": "积分扣减流水ID（user_points_ledger.id）",
"type": "integer"
},
"remark": {
"description": "备注",
"type": "string"
},
"source_type": {
"description": "来源：1商城直购 2抽奖票据 3其他",
"type": "integer"
},
"status": {
"description": "订单状态：1待支付 2已支付 3已取消 4已退款",
"type": "integer"
},
"total_amount": {
"description": "订单总金额（分）",
"type": "integer"
},
"updated_at": {
"description": "更新时间",
"type": "string"
},
"user_address_id": {
"description": "收货地址ID（user_addresses.id）",
"type": "integer"
},
"user_id": {
"description": "下单用户ID（user_members.id）",
"type": "integer"
}
}
}
},
"securityDefinitions": {
"LoginVerifyToken": {
"type": "apiKey",
"name": "Authorization",
"in": "header"
}
}
}
Reference in New Issue View Git Blame Copy Permalink