{ "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}/commit_random": { "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.issueCommitResponse" } }, "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 } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.issueCommitResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/activities/{activity_id}/issues/{issue_id}/commit_random/history": { "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": { "type": "array", "items": { "$ref": "#/definitions/admin.issueCommitResponse" } } }, "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/activities/{activity_id}/issues/{issue_id}/simulate_draw": { "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.simulateDrawRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.simulateDrawResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/activities/{activity_id}/issues/{issue_id}/verify_draw": { "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.verifyDrawRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.verifyDrawResponse" } }, "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/draw_receipts/log/{log_id}": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "通过抽奖日志ID查询收据详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "通过日志ID获取抽奖收据", "parameters": [ { "type": "integer", "description": "日志ID", "name": "log_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.getDrawReceiptResponse" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/draw_receipts/{draw_id}": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "通过抽奖ID查询可验证的抽奖收据详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "获取抽奖收据", "parameters": [ { "type": "integer", "description": "抽奖ID", "name": "draw_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.getDrawReceiptResponse" } }, "404": { "description": "Not Found", "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/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 }, { "type": "string", "description": "用户昵称", "name": "nickname", "in": "query" }, { "type": "string", "description": "邀请码", "name": "inviteCode", "in": "query" }, { "type": "string", "description": "开始日期(YYYY-MM-DD)", "name": "startDate", "in": "query" }, { "type": "string", "description": "结束日期(YYYY-MM-DD)", "name": "endDate", "in": "query" } ], "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": { "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.listUserItemCardsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } }, "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/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": { "post": { "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.executeDrawResponse" } }, "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/me": { "get": { "security": [ { "AppVerifyToken": [] } ], "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/app.myMembershipResponse" } }, "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/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": { "security": [ { "LoginVerifyToken": [] } ], "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}/addresses": { "get": { "security": [ { "LoginVerifyToken": [] } ], "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": "每页条数，默认20，最多100", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listAddressesResponse" } }, "400": { "description": "参数错误", "schema": { "$ref": "#/definitions/code.Failure" } }, "401": { "description": "未授权", "schema": { "$ref": "#/definitions/code.Failure" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/code.Failure" } } } }, "post": { "security": [ { "LoginVerifyToken": [] } ], "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.addAddressRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.addAddressResponse" } }, "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}/addresses/{address_id}": { "delete": { "security": [ { "LoginVerifyToken": [] } ], "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": "地址ID", "name": "address_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.okDeleteResponse" } }, "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}/addresses/{address_id}/default": { "put": { "security": [ { "LoginVerifyToken": [] } ], "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": "地址ID", "name": "address_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.okResponse" } }, "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}/coupons": { "get": { "security": [ { "LoginVerifyToken": [] } ], "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": { "security": [ { "LoginVerifyToken": [] } ], "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": { "security": [ { "LoginVerifyToken": [] } ], "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": { "security": [ { "LoginVerifyToken": [] } ], "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": { "security": [ { "LoginVerifyToken": [] } ], "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": { "security": [ { "LoginVerifyToken": [] } ], "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": { "security": [ { "LoginVerifyToken": [] } ], "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": { "security": [ { "LoginVerifyToken": [] } ], "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/app/users/{user_id}/stats": { "get": { "security": [ { "LoginVerifyToken": [] } ], "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.userStatsResponse" } }, "400": { "description": "参数错误", "schema": { "$ref": "#/definitions/code.Failure" } }, "401": { "description": "未授权", "schema": { "$ref": "#/definitions/code.Failure" } }, "500": { "description": "服务器内部错误", "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.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.deleteGuildResponse": { "type": "object", "properties": { "message": { "type": "string" } } }, "admin.getDrawReceiptResponse": { "type": "object", "properties": { "algo_version": { "type": "string" }, "client_id": { "type": "integer" }, "client_seed": { "type": "string" }, "draw_id": { "type": "integer" }, "draw_log_id": { "type": "integer" }, "id": { "type": "integer" }, "items_root": { "type": "string" }, "items_snapshot": { "type": "string" }, "nonce": { "type": "integer" }, "rand_proof": { "type": "string" }, "round_id": { "type": "integer" }, "selected_index": { "type": "integer" }, "server_seed_hash": { "type": "string" }, "server_sub_seed": { "type": "string" }, "signature": { "type": "string" }, "timestamp": { "type": "integer" }, "weights_total": { "type": "integer" } } }, "admin.issueCommitResponse": { "type": "object", "properties": { "algo_version": { "type": "string" }, "issue_id": { "type": "integer" }, "items_root": { "type": "string" }, "server_seed_hash": { "type": "string" }, "state_version": { "type": "integer" }, "weights_total": { "type": "integer" } } }, "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.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.listRewardsResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/admin.rewardItem" } } } }, "admin.listUserItemCardsResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/user.ItemCardWithTemplate" } }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" } } }, "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.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.simulateDrawRequest": { "type": "object", "properties": { "samples": { "type": "integer" } } }, "admin.simulateDrawResponse": { "type": "object", "properties": { "algo_version": { "type": "string" }, "issue_id": { "type": "integer" }, "items_root": { "type": "string" }, "samples": { "type": "integer" }, "server_seed_hash": { "type": "string" }, "stats": { "type": "array", "items": { "$ref": "#/definitions/admin.simulateItemStat" } }, "weights_total": { "type": "integer" } } }, "admin.simulateItemStat": { "type": "object", "properties": { "count": { "type": "integer" }, "expected_rate": { "type": "number" }, "name": { "type": "string" }, "observed_rate": { "type": "number" }, "quantity": { "type": "integer" }, "reward_id": { "type": "integer" }, "weight": { "type": "integer" } } }, "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" } } }, "admin.verifyDrawRequest": { "type": "object", "required": [ "algo_version", "client_seed", "draw_id", "issue_id", "items_root", "rand_proof", "selected_index", "server_seed_hash", "weights_total" ], "properties": { "algo_version": { "type": "string" }, "client_seed": { "type": "string" }, "draw_id": { "type": "integer" }, "issue_id": { "type": "integer" }, "items_root": { "type": "string" }, "rand_proof": { "type": "string" }, "selected_index": { "type": "integer", "minimum": 0 }, "server_seed_hash": { "type": "string" }, "weights_total": { "type": "integer" } } }, "admin.verifyDrawResponse": { "type": "object", "properties": { "items_root_expected": { "type": "string" }, "message": { "type": "string" }, "server_seed_hash_expected": { "type": "string" }, "valid": { "type": "boolean" } } }, "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.addAddressRequest": { "type": "object", "properties": { "address": { "type": "string" }, "city": { "type": "string" }, "district": { "type": "string" }, "is_default": { "type": "boolean" }, "mobile": { "type": "string" }, "name": { "type": "string" }, "province": { "type": "string" } } }, "app.addAddressResponse": { "type": "object", "properties": { "id": { "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.couponItem": { "type": "object", "properties": { "amount": { "type": "integer" }, "id": { "type": "integer" }, "name": { "type": "string" }, "rules": { "type": "string" }, "status": { "type": "integer" }, "valid_end": { "type": "string" }, "valid_start": { "type": "string" } } }, "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.executeDrawResponse": { "type": "object", "properties": { "receipt": {} } }, "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.listAddressesResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/model.UserAddresses" } }, "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/app.couponItem" } }, "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/user.ItemCardWithTemplate" } }, "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.myMembershipResponse": { "type": "object", "properties": { "join_status": { "type": "integer" }, "role": { "type": "string" }, "status": { "type": "integer" } } }, "app.okDeleteResponse": { "type": "object", "properties": { "ok": { "type": "boolean" } } }, "app.okResponse": { "type": "object", "properties": { "ok": { "type": "boolean" } } }, "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.userStatsResponse": { "type": "object", "properties": { "coupon_count": { "type": "integer" }, "item_card_count": { "type": "integer" }, "points_balance": { "type": "integer" } } }, "app.weixinLoginRequest": { "type": "object", "properties": { "code": { "type": "string" }, "douyin_id": { "type": "string" }, "invite_code": { "type": "string" } } }, "app.weixinLoginResponse": { "type": "object", "properties": { "avatar": { "type": "string" }, "invite_code": { "type": "string" }, "nickname": { "type": "string" }, "token": { "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.UserAddresses": { "type": "object", "properties": { "address": { "description": "详细地址", "type": "string" }, "city": { "description": "市", "type": "string" }, "created_at": { "description": "创建时间", "type": "string" }, "default_user_unique": { "description": "用于唯一约束的生成列：默认地址→user_id", "type": "integer" }, "district": { "description": "区/县", "type": "string" }, "id": { "description": "主键ID", "type": "integer" }, "is_default": { "description": "是否默认地址：0否 1是", "type": "integer" }, "mobile": { "description": "收件人手机号", "type": "string" }, "name": { "description": "收件人姓名", "type": "string" }, "province": { "description": "省", "type": "string" }, "updated_at": { "description": "更新时间", "type": "string" }, "user_id": { "description": "用户ID（user_members.id）", "type": "integer" } } }, "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.ItemCardWithTemplate": { "type": "object", "properties": { "card_id": { "description": "卡模板ID（system_item_cards.id）", "type": "integer" }, "card_type": { "type": "integer" }, "created_at": { "description": "创建时间", "type": "string" }, "effect_type": { "type": "integer" }, "id": { "description": "主键ID", "type": "integer" }, "name": { "type": "string" }, "remark": { "type": "string" }, "scope_type": { "type": "integer" }, "stacking_strategy": { "type": "integer" }, "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" } } }, "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" } } }