// Package docs Code generated by swaggo/swag. DO NOT EDIT package docs import "github.com/swaggo/swag" const docTemplate = `{ "schemes": {{ marshal .Schemes }}, "swagger": "2.0", "info": { "description": "{{escape .Description}}", "title": "{{.Title}}", "contact": {}, "version": "{{.Version}}" }, "host": "{{.Host}}", "basePath": "{{.BasePath}}", "paths": { "/admin/task_center/simulate/invite_success": { "post": { "description": "模拟用户邀请成功，触发任务进度更新", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "模拟邀请成功(Admin)", "parameters": [ { "description": "模拟请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/taskcenter.simulateInviteSuccessRequest" } } ], "responses": { "200": { "description": "操作成功", "schema": { "type": "object", "additionalProperties": true } } } } }, "/admin/task_center/simulate/order_paid": { "post": { "description": "模拟用户支付订单，触发任务进度更新", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "模拟订单支付(Admin)", "parameters": [ { "description": "模拟请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/taskcenter.simulateOrderPaidRequest" } } ], "responses": { "200": { "description": "操作成功", "schema": { "type": "object", "additionalProperties": true } } } } }, "/admin/task_center/tasks": { "get": { "description": "获取任务管理列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "任务列表(Admin)", "responses": { "200": { "description": "任务列表", "schema": { "type": "object", "additionalProperties": true } } } }, "post": { "description": "创建一个新的任务", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "创建任务(Admin)", "parameters": [ { "description": "创建任务请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/taskcenter.createTaskRequest" } } ], "responses": { "200": { "description": "创建成功", "schema": { "type": "object", "additionalProperties": true } } } } }, "/admin/task_center/tasks/{id}": { "put": { "description": "修改指定任务的信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "修改任务(Admin)", "parameters": [ { "type": "integer", "description": "任务ID", "name": "id", "in": "path", "required": true }, { "description": "修改任务请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/taskcenter.modifyTaskRequest" } } ], "responses": { "200": { "description": "修改成功", "schema": { "type": "object", "additionalProperties": true } } } }, "delete": { "description": "删除指定的任务", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "删除任务(Admin)", "parameters": [ { "type": "integer", "description": "任务ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "type": "object", "additionalProperties": true } } } } }, "/admin/task_center/tasks/{id}/rewards": { "get": { "description": "获取任务层级对应的奖励列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "获取任务奖励(Admin)", "parameters": [ { "type": "integer", "description": "任务ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "奖励列表", "schema": { "type": "object", "additionalProperties": true } } } }, "post": { "description": "设置任务层级对应的奖励", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "设置任务奖励(Admin)", "parameters": [ { "type": "integer", "description": "任务ID", "name": "id", "in": "path", "required": true }, { "description": "设置奖励请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/taskcenter.upsertRewardsRequest" } } ], "responses": { "200": { "description": "设置成功", "schema": { "type": "object", "additionalProperties": true } } } } }, "/admin/task_center/tasks/{id}/tiers": { "get": { "description": "获取任务的完成条件层级列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "获取任务层级(Admin)", "parameters": [ { "type": "integer", "description": "任务ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "层级列表", "schema": { "type": "object", "additionalProperties": true } } } }, "post": { "description": "设置任务的完成条件层级", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(Admin)" ], "summary": "设置任务层级(Admin)", "parameters": [ { "type": "integer", "description": "任务ID", "name": "id", "in": "path", "required": true }, { "description": "设置层级请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/taskcenter.upsertTiersRequest" } } ], "responses": { "200": { "description": "设置成功", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/admin/activities": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "获取活动列表，支持分类、Boss、状态过滤与分页", "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": "是否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/admin.listActivitiesResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } }, "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/admin.activityDetailResponse" } }, "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}/copy": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "根据活动ID深度复制期次与奖品，生成新的活动", "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.copyActivityResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/activities/{activity_id}/issues": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "获取指定活动的期数列表，支持分页", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "查看活动期数", "parameters": [ { "type": "integer", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "type": "integer", "default": 1, "description": "页码", "name": "page", "in": "query", "required": true }, { "type": "integer", "default": 20, "description": "每页数量，最多100", "name": "page_size", "in": "query", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.listIssuesResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } }, "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "为指定活动创建一个新的期数", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "创建活动期数", "parameters": [ { "type": "integer", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/admin.createIssueRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.simpleMessage" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/activities/{activity_id}/issues/{issue_id}": { "put": { "security": [ { "LoginVerifyToken": [] } ], "description": "修改指定期数的信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "修改活动期数", "parameters": [ { "type": "integer", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "type": "integer", "description": "期ID", "name": "issue_id", "in": "path", "required": true }, { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/admin.modifyIssueRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.simpleMessage" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } }, "delete": { "security": [ { "LoginVerifyToken": [] } ], "description": "删除指定期数", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "删除活动期数", "parameters": [ { "type": "integer", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "type": "integer", "description": "期ID", "name": "issue_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.simpleMessage" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/activities/{activity_id}/issues/{issue_id}/rewards": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "查看指定期数的奖励配置列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "查看期数奖品", "parameters": [ { "type": "integer", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "type": "integer", "description": "期ID", "name": "issue_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.listRewardsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } }, "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "为指定期数批量创建奖励配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "创建期数奖品", "parameters": [ { "type": "integer", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "type": "integer", "description": "期ID", "name": "issue_id", "in": "path", "required": true }, { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/admin.createRewardsRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.simpleMessageResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/activities/{activity_id}/issues/{issue_id}/rewards/batch": { "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 }, { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/admin.batchModifyRewardsRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.simpleMessageResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/activities/{activity_id}/issues/{issue_id}/rewards/{reward_id}": { "put": { "security": [ { "LoginVerifyToken": [] } ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "更新期数奖励", "parameters": [ { "type": "integer", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "type": "integer", "description": "期ID", "name": "issue_id", "in": "path", "required": true }, { "type": "integer", "description": "奖励ID", "name": "reward_id", "in": "path", "required": true }, { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/admin.modifyRewardRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.simpleMessageResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } }, "delete": { "security": [ { "LoginVerifyToken": [] } ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "删除期数奖励", "parameters": [ { "type": "integer", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "type": "integer", "description": "期ID", "name": "issue_id", "in": "path", "required": true }, { "type": "integer", "description": "奖励ID", "name": "reward_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.simpleMessageResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/activity_categories": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "获取启用状态的活动分类列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.活动" ], "summary": "活动分类列表", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.listCategoriesResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/auth/refresh": { "post": { "security": [ { "LoginVerifyToken": [] } ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.登录" ], "summary": "管理端令牌刷新", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.refreshResponse" } }, "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/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/matching_card_types": { "get": { "security": [ { "AdminAuth": [] } ], "description": "获取所有卡牌类型配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.对对碰" ], "summary": "列出对对碰卡牌类型", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.listMatchingCardTypesResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } }, "post": { "security": [ { "AdminAuth": [] } ], "description": "创建新的卡牌类型", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.对对碰" ], "summary": "创建卡牌类型", "parameters": [ { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/admin.matchingCardTypeRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.matchingCardTypeResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/matching_card_types/{id}": { "put": { "security": [ { "AdminAuth": [] } ], "description": "修改已有的卡牌类型", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.对对碰" ], "summary": "修改卡牌类型", "parameters": [ { "type": "integer", "description": "卡牌类型ID", "name": "id", "in": "path", "required": true }, { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/admin.matchingCardTypeRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.matchingCardTypeResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } }, "delete": { "security": [ { "AdminAuth": [] } ], "description": "删除指定的卡牌类型", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.对对碰" ], "summary": "删除卡牌类型", "parameters": [ { "type": "integer", "description": "卡牌类型ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "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/batch": { "put": { "security": [ { "LoginVerifyToken": [] } ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.商品" ], "summary": "批量更新商品（库存/上下架）", "parameters": [ { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/admin.batchUpdateProductsRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.batchUpdateProductsResponse" } }, "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/shipping/orders": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "按批次号或运单号聚合显示发货记录，支持筛选状态、用户、时间等", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.发货管理" ], "summary": "发货订单列表", "parameters": [ { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，最多100，默认20", "name": "page_size", "in": "query" }, { "type": "integer", "description": "状态：1待发货 2已发货 3已签收 4异常", "name": "status", "in": "query" }, { "type": "integer", "description": "用户ID", "name": "user_id", "in": "query" }, { "type": "string", "description": "批次号", "name": "batch_no", "in": "query" }, { "type": "string", "description": "运单号", "name": "express_no", "in": "query" }, { "type": "string", "description": "开始日期 2006-01-02", "name": "start_date", "in": "query" }, { "type": "string", "description": "结束日期 2006-01-02", "name": "end_date", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.listShippingOrdersResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/shipping/orders/batch": { "put": { "security": [ { "LoginVerifyToken": [] } ], "description": "为多条发货记录填写运单号或更新状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.发货管理" ], "summary": "批量更新发货信息", "parameters": [ { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/admin.updateShippingRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.updateShippingResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/admin/shipping/orders/{id}": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "根据发货记录ID获取详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.发货管理" ], "summary": "获取发货订单详情", "parameters": [ { "type": "integer", "description": "发货记录ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/model.ShippingRecords" } }, "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/admin/users/{user_id}/token": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "仅超级管理员可用，用于测试或紧急场景下为指定用户签发APP令牌", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "管理端.用户" ], "summary": "管理端为APP用户签发令牌", "parameters": [ { "type": "integer", "description": "用户ID", "name": "user_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/admin.issueUserTokenResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/activities": { "get": { "description": "获取活动列表，支持分类、Boss、状态过滤与分页", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.活动" ], "summary": "活动列表", "parameters": [ { "type": "string", "description": "活动名称(模糊)", "name": "name", "in": "query" }, { "type": "integer", "description": "活动分类ID", "name": "category_id", "in": "query" }, { "type": "integer", "description": "是否Boss(0/1)", "name": "is_boss", "in": "query" }, { "type": "integer", "description": "状态(1进行中 2下线)", "name": "status", "in": "query" }, { "type": "integer", "default": 1, "description": "页码", "name": "page", "in": "query", "required": true }, { "type": "integer", "default": 20, "description": "每页数量，最多100", "name": "page_size", "in": "query", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listActivitiesResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/activities/{activity_id}": { "get": { "description": "获取指定活动的详细信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.活动" ], "summary": "活动详情", "parameters": [ { "type": "integer", "description": "活动ID", "name": "activity_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.activityDetailResponse" } }, "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}/choices": { "get": { "description": "返回总位置数量、已占用位置列表以及当前可选位置列表。仅在活动玩法为 ichiban 时可用。", "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.listIssueChoicesResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/activities/{activity_id}/issues/{issue_id}/draw_logs": { "get": { "description": "查看指定活动期数的抽奖记录，支持等级筛选（默认返回最新的100条，不支持自定义翻页）", "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", "description": "奖品等级过滤", "name": "level", "in": "query" } ], "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}/draw_logs_grouped": { "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.listDrawLogsByLevelResponse" } }, "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/address-share/submit": { "post": { "description": "被邀请者使用分享令牌提交收件信息；服务端校验令牌有效并创建待发货记录（极简方案）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.用户" ], "summary": "提交共享地址", "parameters": [ { "description": "请求参数：令牌与地址信息", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.addressShareSubmitRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.addressShareSubmitResponse" } }, "400": { "description": "令牌无效/已处理/资产不可用", "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/categories": { "get": { "description": "获取APP端商品分类列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.基础" ], "summary": "获取分类列表", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listAppCategoriesResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/lottery/join": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "提交活动ID与期ID创建参与记录与订单，支持积分抵扣，返回参与ID、订单号、抽奖模式及是否进入队列", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.抽奖" ], "summary": "用户参与抽奖", "parameters": [ { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.joinLotteryRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.joinLotteryResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/lottery/result": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "根据订单号查询抽奖结果与进度，返回结果明细与可验证凭证；需登录", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.抽奖" ], "summary": "抽奖订单结果查询", "parameters": [ { "type": "string", "description": "订单号", "name": "order_no", "in": "query", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.orderResultResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/matching/card_types": { "get": { "description": "获取所有启用的卡牌类型配置，用于App端预览或动画展示", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.活动" ], "summary": "列出对对碰卡牌类型", "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/app.CardTypeConfig" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/matching/check": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "前端游戏结束后上报结果，服务器发放奖励", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.活动" ], "summary": "游戏结束结算校验", "parameters": [ { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.matchingGameCheckRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.matchingGameCheckResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/matching/preorder": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "用户下单，服务器扣费并返回全量99张乱序卡牌，前端自行负责游戏流程", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.活动" ], "summary": "下单并获取对对碰全量数据", "parameters": [ { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.matchingGamePreOrderRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.matchingGamePreOrderResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/matching/state": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "获取当前游戏的完整状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.活动" ], "summary": "获取对对碰游戏状态", "parameters": [ { "type": "string", "description": "游戏ID", "name": "game_id", "in": "query", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/notices": { "get": { "description": "获取APP首页滚动公告", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.基础" ], "summary": "获取公告列表", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listAppNoticesResponse" } } } } }, "/api/app/orders/{order_id}": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "获取指定订单的详细信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.用户" ], "summary": "获取订单详情", "parameters": [ { "type": "integer", "description": "订单ID", "name": "order_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/user.OrderWithItems" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/orders/{order_id}/cancel": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "取消指定订单（仅限待付款状态）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.用户" ], "summary": "取消订单", "parameters": [ { "type": "integer", "description": "订单ID", "name": "order_id", "in": "path", "required": true }, { "description": "取消原因", "name": "body", "in": "body", "schema": { "$ref": "#/definitions/app.cancelOrderRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.cancelOrderResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/pay/wechat/jsapi/preorder": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "根据` + "`" + `order_no` + "`" + `与` + "`" + `openid` + "`" + `创建或复用JSAPI预下单，返回` + "`" + `wx.requestPayment` + "`" + `调起参数；订单需为当前登录用户且状态为待支付", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.支付" ], "summary": "小程序微信支付预下单", "parameters": [ { "description": "请求参数：业务订单号与openid", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.jsapiPreorderRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.jsapiPreorderResponse" } }, "400": { "description": "参数错误/配置缺失/订单不存在或状态不合法/微信预下单失败/签名构建失败", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/products": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "分页查询商品列表，支持分类筛选，返回分页信息与商品数组", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.商品" ], "summary": "商品列表", "parameters": [ { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认20", "name": "page_size", "in": "query" }, { "type": "integer", "description": "分类ID", "name": "category_id", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listAppProductsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/products/{id}": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "根据商品ID返回完整商品信息，含相册与同类推荐；校验下架/缺货状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.商品" ], "summary": "商品详情", "parameters": [ { "type": "integer", "description": "商品ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.getAppProductDetailResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/store/items": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "分页获取积分商城商品列表，支持按类型筛选(product/item_card/coupon)", "consumes": [ "application/x-www-form-urlencoded" ], "produces": [ "application/json" ], "tags": [ "APP端.积分商城" ], "summary": "获取积分商城商品列表", "parameters": [ { "type": "string", "description": "商品类型: product(默认), item_card, coupon", "name": "kind", "in": "query" }, { "type": "integer", "default": 1, "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "default": 20, "description": "每页数量", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listStoreItemsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/task-center/tasks": { "get": { "description": "获取当前可用的任务列表，支持分页", "consumes": [ "application/x-www-form-urlencoded" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(App)" ], "summary": "获取任务列表(App)", "parameters": [ { "type": "integer", "default": 1, "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "default": 20, "description": "每页数量", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "任务列表", "schema": { "$ref": "#/definitions/taskcenter.listTasksResponse" } } } } }, "/api/app/task-center/tasks/{id}/claim/{user_id}": { "post": { "description": "用户领取指定任务层级的奖励", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(App)" ], "summary": "领取任务奖励(App)", "parameters": [ { "type": "integer", "description": "任务ID", "name": "id", "in": "path", "required": true }, { "type": "integer", "description": "用户ID", "name": "user_id", "in": "path", "required": true }, { "description": "领取请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/taskcenter.claimTaskRequest" } } ], "responses": { "200": { "description": "领取成功", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/app/task-center/tasks/{id}/progress/{user_id}": { "get": { "description": "获取指定用户在特定任务上的进度详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "TaskCenter(App)" ], "summary": "获取用户任务进度(App)", "parameters": [ { "type": "integer", "description": "任务ID", "name": "id", "in": "path", "required": true }, { "type": "integer", "description": "用户ID", "name": "user_id", "in": "path", "required": true } ], "responses": { "200": { "description": "任务进度详情", "schema": { "$ref": "#/definitions/taskcenter.taskProgressResponse" } } } } }, "/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 }, { "type": "integer", "description": "状态：1未使用 2已使用 3已过期，不传默认1", "name": "status", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listCouponsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/coupons/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.couponStatsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/coupons/{user_coupon_id}/usage": { "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": "用户优惠券ID", "name": "user_coupon_id", "in": "path", "required": true }, { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认20", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listCouponUsageResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/inventory": { "get": { "security": [ { "LoginVerifyToken": [] } ], "description": "获取 APP 端当前登录用户在 user_inventory 的资产记录，支持分页", "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": "每页数量，最多100，默认20", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listInventoryResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/inventory/address-share/create": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "生成一次性分享令牌（不落库），用于邀请他人填写收货地址；令牌默认有效期1小时（无需传过期参数）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.用户" ], "summary": "创建共享地址链接", "parameters": [ { "type": "integer", "description": "用户ID", "name": "user_id", "in": "path", "required": true }, { "description": "请求参数：资产ID（过期参数可不传，默认1小时）", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.addressShareCreateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.addressShareCreateResponse" } }, "400": { "description": "参数错误/资产不可用", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/inventory/address-share/revoke": { "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": "请求参数：资产ID", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.addressShareRevokeRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.okResponse" } }, "400": { "description": "参数错误", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/inventory/redeem": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "将资产按规则转换为积分，成功后资产不可再发货；默认兑换比率来自系统配置` + "`" + `points_exchange_per_cent` + "`" + `", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.用户" ], "summary": "资产兑换为积分", "parameters": [ { "type": "integer", "description": "用户ID", "name": "user_id", "in": "path", "required": true }, { "description": "请求参数：资产ID", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.redeemInventoryRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.redeemInventoryResponse" } }, "400": { "description": "参数错误/资产不可用", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/inventory/request-shipping": { "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": "请求参数：资产ID", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.requestShippingRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.requestShippingResponse" } }, "400": { "description": "参数错误/未设置默认地址/已处理", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/inventory/request-shipping-batch": { "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": "请求参数：资产ID列表与可选地址ID", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.requestShippingBatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.requestShippingBatchResponse" } }, "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" }, { "type": "integer", "description": "状态：1未使用 2已使用 3已过期，不传默认1", "name": "status", "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 }, { "type": "integer", "description": "订单状态：1待支付 2已支付 3已取消 4已退款", "name": "status", "in": "query" }, { "type": "integer", "description": "是否已消耗/履约：0否 1是", "name": "is_consumed", "in": "query" } ], "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}/points/redeem-coupon": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "使用积分兑换指定直减金额券，按比率 1元=100积分（券面值为分）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.积分" ], "summary": "积分兑换优惠券", "parameters": [ { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.redeemCouponRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.redeemCouponResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/points/redeem-item-card": { "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": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.redeemItemCardRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.redeemItemCardResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/points/redeem-product": { "post": { "security": [ { "LoginVerifyToken": [] } ], "description": "使用积分按比率1元=100积分兑换商品，生成系统发放订单与用户资产", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "APP端.积分" ], "summary": "积分兑换商品", "parameters": [ { "description": "请求参数", "name": "RequestBody", "in": "body", "required": true, "schema": { "$ref": "#/definitions/app.redeemProductRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.redeemProductResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/code.Failure" } } } } }, "/api/app/users/{user_id}/shipments": { "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": "每页数量，最多100，默认20", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/app.listShipmentsResponse" } }, "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": {} } }, "/common/upload/wangeditor": { "post": { "description": "适配 WangEditor 的图片上传接口", "consumes": [ "multipart/form-data" ], "produces": [ "application/json" ], "tags": [ "Common" ], "summary": "WangEditor图片上传", "parameters": [ { "type": "file", "description": "图片文件", "name": "file", "in": "formData", "required": true } ], "responses": { "200": { "description": "上传成功", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "上传失败", "schema": { "type": "object", "additionalProperties": true } } } } }, "/internal/game/settle": { "post": { "description": "游戏结束后结算并发放奖励", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "Internal" ], "summary": "结算游戏", "parameters": [ { "description": "结算信息", "name": "result", "in": "body", "required": true, "schema": { "$ref": "#/definitions/minesweeper.SettleGameRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/minesweeper.SettleGameResponse" } } } } }, "/internal/game/verify": { "post": { "description": "验证游戏票据是否有效", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "Internal" ], "summary": "验证游戏票据", "parameters": [ { "description": "票据信息", "name": "ticket", "in": "body", "required": true, "schema": { "$ref": "#/definitions/minesweeper.VerifyTicketRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/minesweeper.VerifyTicketResponse" } } } } }, "/pay/wechat/notify": { "post": { "description": "接收微信支付结果通知，验证签名并处理订单状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "Pay" ], "summary": "微信支付回调通知", "responses": { "200": { "description": "处理成功", "schema": { "$ref": "#/definitions/pay.notifyAck" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/pay.notifyAck" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/pay.notifyAck" } } } } } }, "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.ShippingOrderGroup": { "type": "object", "properties": { "address_id": { "description": "地址ID", "type": "integer" }, "address_info": { "description": "地址信息", "type": "string" }, "batch_no": { "description": "批次号", "type": "string" }, "count": { "description": "商品数量", "type": "integer" }, "created_at": { "type": "string" }, "express_code": { "description": "快递公司编码", "type": "string" }, "express_no": { "description": "运单号", "type": "string" }, "group_key": { "description": "分组键（用于批量操作）", "type": "string" }, "inventory_ids": { "description": "资产ID列表", "type": "array", "items": { "type": "integer" } }, "product_ids": { "description": "商品ID列表", "type": "array", "items": { "type": "integer" } }, "products": { "description": "商品详情列表", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "image": { "type": "string" }, "name": { "type": "string" }, "price": { "type": "integer" } } } }, "received_at": { "type": "string" }, "record_ids": { "description": "发货记录ID列表", "type": "array", "items": { "type": "integer" } }, "shipped_at": { "type": "string" }, "status": { "description": "状态（取最大值）", "type": "integer" }, "total_price": { "description": "总价格", "type": "integer" }, "user_id": { "description": "用户ID", "type": "integer" }, "user_nickname": { "description": "用户昵称", "type": "string" } } }, "admin.activityDetailResponse": { "type": "object", "properties": { "activity_category_id": { "type": "integer" }, "allow_coupons": { "type": "boolean" }, "allow_item_cards": { "type": "boolean" }, "banner": { "type": "string" }, "created_at": { "type": "string" }, "draw_mode": { "type": "string" }, "end_time": { "type": "string" }, "gameplay_intro": { "type": "string" }, "id": { "type": "integer" }, "image": { "type": "string" }, "interval_minutes": { "type": "integer" }, "is_boss": { "type": "integer" }, "last_settled_at": { "type": "string" }, "min_participants": { "type": "integer" }, "name": { "type": "string" }, "play_type": { "type": "string" }, "price_draw": { "type": "integer" }, "refund_coupon_id": { "type": "integer" }, "scheduled_time": { "type": "string" }, "start_time": { "type": "string" }, "status": { "type": "integer" }, "updated_at": { "type": "string" } } }, "admin.activityItem": { "type": "object", "properties": { "activity_category_id": { "type": "integer" }, "banner": { "type": "string" }, "category_name": { "type": "string" }, "id": { "type": "integer" }, "image": { "type": "string" }, "is_boss": { "type": "integer" }, "name": { "type": "string" }, "price_draw": { "type": "integer" }, "status": { "type": "integer" } } }, "admin.activitysvcIssueData": { "type": "object", "properties": { "id": { "type": "integer" }, "issue_number": { "type": "string" }, "prize_count": { "type": "integer" }, "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": { "balance_amount": { "type": "integer" }, "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" }, "channel_code": { "type": "string" }, "channel_name": { "type": "string" }, "coupons_count": { "type": "integer" }, "created_at": { "type": "string" }, "douyin_id": { "type": "string" }, "id": { "type": "integer" }, "invite_code": { "type": "string" }, "inviter_id": { "type": "integer" }, "item_cards_count": { "type": "integer" }, "nickname": { "type": "string" }, "seven_day_consume": { "type": "integer" }, "today_consume": { "type": "integer" } } }, "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.batchModifyRewardItem": { "type": "object", "required": [ "reward_id" ], "properties": { "reward_id": { "type": "integer" }, "weight": { "type": "integer", "minimum": 0 } } }, "admin.batchModifyRewardsRequest": { "type": "object", "required": [ "rewards" ], "properties": { "rewards": { "type": "array", "items": { "$ref": "#/definitions/admin.batchModifyRewardItem" } } } }, "admin.batchUpdateProductsRequest": { "type": "object", "required": [ "ids" ], "properties": { "ids": { "type": "array", "items": { "type": "integer" } }, "status": { "type": "integer" }, "stock": { "type": "integer" } } }, "admin.batchUpdateProductsResponse": { "type": "object", "properties": { "message": { "type": "string" }, "updated_count": { "type": "integer" } } }, "admin.categoryItem": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } }, "admin.copyActivityResponse": { "type": "object", "properties": { "new_activity_id": { "type": "integer" }, "status": { "type": "string" } } }, "admin.createActivityRequest": { "type": "object", "required": [ "activity_category_id", "name" ], "properties": { "activity_category_id": { "type": "integer" }, "allow_coupons": { "type": "integer" }, "allow_item_cards": { "type": "integer" }, "banner": { "type": "string" }, "draw_mode": { "type": "string" }, "end_time": { "type": "string" }, "gameplay_intro": { "type": "string" }, "image": { "type": "string" }, "interval_minutes": { "type": "integer" }, "is_boss": { "type": "integer" }, "min_participants": { "type": "integer" }, "name": { "type": "string" }, "play_type": { "type": "string" }, "price_draw": { "type": "integer" }, "refund_coupon_amount": { "type": "number" }, "refund_coupon_id": { "type": "integer" }, "refund_coupon_type": { "type": "string" }, "scheduled_delay_minutes": { "type": "integer" }, "scheduled_time": { "type": "string" }, "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.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.issueUserTokenResponse": { "type": "object", "properties": { "expires_in": { "type": "integer" }, "token": { "type": "string" } } }, "admin.itemCardListItem": { "type": "object", "properties": { "activity_category_id": { "type": "integer" }, "activity_id": { "type": "integer" }, "boost_rate_x1000": { "type": "integer" }, "card_type": { "type": "integer" }, "created_at": { "type": "string" }, "effect_type": { "type": "integer" }, "id": { "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" }, "updated_at": { "type": "string" }, "valid_end": { "type": "string" }, "valid_start": { "type": "string" } } }, "admin.listActivitiesResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/admin.activityItem" } }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" } } }, "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.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.listMatchingCardTypesResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/admin.matchingCardTypeResponse" } }, "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.listShippingOrdersResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/admin.ShippingOrderGroup" } }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" } } }, "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.matchingCardTypeRequest": { "type": "object", "required": [ "code", "name" ], "properties": { "code": { "type": "string" }, "image_url": { "type": "string" }, "name": { "type": "string" }, "quantity": { "type": "integer" }, "sort": { "type": "integer" }, "status": { "type": "integer" } } }, "admin.matchingCardTypeResponse": { "type": "object", "properties": { "code": { "type": "string" }, "created_at": { "type": "string" }, "id": { "type": "integer" }, "image_url": { "type": "string" }, "name": { "type": "string" }, "quantity": { "type": "integer" }, "sort": { "type": "integer" }, "status": { "type": "integer" } } }, "admin.modifyActivityRequest": { "type": "object", "properties": { "activity_category_id": { "type": "integer" }, "allow_coupons": { "type": "integer" }, "allow_item_cards": { "type": "integer" }, "banner": { "type": "string" }, "draw_mode": { "type": "string" }, "end_time": { "type": "string" }, "gameplay_intro": { "type": "string" }, "image": { "type": "string" }, "interval_minutes": { "type": "integer" }, "is_boss": { "type": "integer" }, "min_participants": { "type": "integer" }, "name": { "type": "string" }, "play_type": { "type": "string" }, "price_draw": { "type": "integer" }, "refund_coupon_amount": { "type": "number" }, "refund_coupon_id": { "type": "integer" }, "refund_coupon_type": { "type": "string" }, "scheduled_delay_minutes": { "type": "integer" }, "scheduled_time": { "type": "string" }, "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.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" }, "min_score": { "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.refreshResponse": { "type": "object", "properties": { "expires_in": { "type": "integer" }, "token": { "type": "string" } } }, "admin.rewardItem": { "type": "object", "required": [ "level", "name", "original_qty", "quantity", "weight" ], "properties": { "id": { "type": "integer" }, "is_boss": { "type": "integer" }, "level": { "type": "integer" }, "min_score": { "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.updateShippingRequest": { "type": "object", "properties": { "express_code": { "description": "快递公司编码", "type": "string" }, "express_no": { "description": "运单号", "type": "string" }, "record_ids": { "description": "发货记录ID列表", "type": "array", "items": { "type": "integer" } }, "status": { "description": "状态", "type": "integer" } } }, "admin.updateShippingResponse": { "type": "object", "properties": { "success": { "type": "boolean" }, "updated_count": { "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" } } }, "app.CardTypeConfig": { "type": "object", "properties": { "code": { "type": "string" }, "image_url": { "type": "string" }, "name": { "type": "string" }, "quantity": { "type": "integer" } } }, "app.MatchingCard": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } } }, "app.MatchingRewardInfo": { "type": "object", "properties": { "level": { "type": "integer" }, "name": { "type": "string" }, "reward_id": { "type": "integer" } } }, "app.activityDetailResponse": { "type": "object", "properties": { "activity_category_id": { "type": "integer" }, "allow_coupons": { "type": "boolean" }, "allow_item_cards": { "type": "boolean" }, "banner": { "type": "string" }, "created_at": { "type": "string" }, "draw_mode": { "type": "string" }, "end_time": { "type": "string" }, "gameplay_intro": { "type": "string" }, "id": { "type": "integer" }, "image": { "type": "string" }, "interval_minutes": { "type": "integer" }, "is_boss": { "type": "integer" }, "last_settled_at": { "type": "string" }, "min_participants": { "type": "integer" }, "name": { "type": "string" }, "play_type": { "type": "string" }, "price_draw": { "type": "integer" }, "refund_coupon_id": { "type": "integer" }, "scheduled_time": { "type": "string" }, "start_time": { "type": "string" }, "status": { "type": "integer" }, "updated_at": { "type": "string" } } }, "app.activityItem": { "type": "object", "properties": { "activity_category_id": { "type": "integer" }, "banner": { "type": "string" }, "category_name": { "type": "string" }, "id": { "type": "integer" }, "image": { "type": "string" }, "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.addressShareCreateRequest": { "type": "object", "properties": { "expires_at": { "type": "string" }, "expires_in_minutes": { "type": "integer" }, "inventory_id": { "type": "integer" } } }, "app.addressShareCreateResponse": { "type": "object", "properties": { "expires_at": { "type": "string" }, "share_token": { "type": "string" }, "share_url": { "type": "string" } } }, "app.addressShareRevokeRequest": { "type": "object", "properties": { "inventory_id": { "type": "integer" } } }, "app.addressShareSubmitRequest": { "type": "object", "properties": { "address": { "type": "string" }, "city": { "type": "string" }, "district": { "type": "string" }, "mobile": { "type": "string" }, "name": { "type": "string" }, "province": { "type": "string" }, "share_token": { "type": "string" } } }, "app.addressShareSubmitResponse": { "type": "object", "properties": { "address_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.appCategoryItem": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } }, "app.appNoticeItem": { "type": "object", "properties": { "content": { "type": "string" } } }, "app.bindPhoneRequest": { "type": "object", "properties": { "code": { "type": "string" } } }, "app.bindPhoneResponse": { "type": "object", "properties": { "mobile": { "type": "string" }, "success": { "type": "boolean" } } }, "app.cancelOrderRequest": { "type": "object", "properties": { "reason": { "type": "string" } } }, "app.cancelOrderResponse": { "type": "object", "properties": { "cancelled_at": { "type": "string" }, "order_id": { "type": "integer" }, "order_no": { "type": "string" }, "status": { "type": "integer" } } }, "app.couponDetail": { "type": "object", "properties": { "amount": { "description": "原始面值", "type": "integer" }, "id": { "type": "integer" }, "name": { "type": "string" }, "remaining": { "description": "剩余额度", "type": "integer" }, "status": { "type": "integer" }, "use_count": { "description": "使用次数", "type": "integer" }, "used_amount": { "description": "累计已使用金额", "type": "integer" }, "valid_end": { "type": "string" }, "valid_start": { "type": "string" } } }, "app.couponItem": { "type": "object", "properties": { "amount": { "type": "integer" }, "id": { "type": "integer" }, "name": { "type": "string" }, "remaining": { "type": "integer" }, "rules": { "type": "string" }, "status": { "type": "integer" }, "used_at": { "description": "使用时间（已使用时返回）", "type": "string" }, "valid_end": { "type": "string" }, "valid_start": { "type": "string" } } }, "app.couponStatsResponse": { "type": "object", "properties": { "expired_count": { "description": "已过期优惠券数量", "type": "integer" }, "total_remaining": { "description": "可用优惠券总余额（分）", "type": "integer" }, "total_saved": { "description": "累计节省金额（分）", "type": "integer" }, "unused_count": { "description": "可用优惠券数量", "type": "integer" }, "used_count": { "description": "已使用优惠券数量", "type": "integer" } } }, "app.couponUsageItem": { "type": "object", "properties": { "activity_name": { "description": "活动名称", "type": "string" }, "amount": { "description": "本次使用金额（正数）", "type": "integer" }, "created_at": { "type": "string" }, "id": { "type": "integer" }, "order_no": { "description": "订单号", "type": "string" } } }, "app.drawLogGroup": { "type": "object", "properties": { "level": { "type": "integer" }, "level_name": { "type": "string" }, "list": { "type": "array", "items": { "$ref": "#/definitions/app.drawLogItem" } } } }, "app.drawLogItem": { "type": "object", "properties": { "avatar": { "type": "string" }, "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" }, "reward_image": { "type": "string" }, "reward_name": { "type": "string" }, "user_id": { "type": "integer" }, "user_name": { "type": "string" } } }, "app.getAppProductDetailResponse": { "type": "object", "properties": { "album": { "type": "array", "items": { "type": "string" } }, "description": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "price": { "type": "integer" }, "recommendations": { "type": "array", "items": { "$ref": "#/definitions/app.listAppProductsItem" } }, "sales": { "type": "integer" }, "service": { "type": "array", "items": { "type": "string" } }, "stock": { "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" }, "remaining_prize_quantity": { "type": "integer" }, "sort": { "type": "integer" }, "status": { "type": "integer" }, "total_prize_quantity": { "type": "integer" } } }, "app.joinLotteryRequest": { "type": "object", "properties": { "activity_id": { "type": "integer" }, "channel": { "type": "string" }, "count": { "type": "integer" }, "coupon_id": { "type": "integer" }, "issue_id": { "type": "integer" }, "item_card_id": { "type": "integer" }, "slot_index": { "type": "array", "items": { "type": "integer" } }, "use_points": { "type": "integer" } } }, "app.joinLotteryResponse": { "type": "object", "properties": { "draw_mode": { "type": "string" }, "join_id": { "type": "string" }, "order_no": { "type": "string" }, "queued": { "type": "boolean" }, "reward_id": { "type": "integer" }, "reward_name": { "type": "string" } } }, "app.jsapiPreorderRequest": { "type": "object", "properties": { "openid": { "type": "string" }, "order_no": { "type": "string" } } }, "app.jsapiPreorderResponse": { "type": "object", "properties": { "nonceStr": { "type": "string" }, "package": { "type": "string" }, "paySign": { "type": "string" }, "signType": { "type": "string" }, "timeStamp": { "type": "string" } } }, "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.listAppCategoriesResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/app.appCategoryItem" } } } }, "app.listAppNoticesResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/app.appNoticeItem" } } } }, "app.listAppProductsItem": { "type": "object", "properties": { "id": { "type": "integer" }, "in_stock": { "type": "boolean" }, "main_image": { "type": "string" }, "name": { "type": "string" }, "price": { "type": "integer" }, "sales": { "type": "integer" } } }, "app.listAppProductsResponse": { "type": "object", "properties": { "currentPage": { "type": "integer" }, "list": { "type": "array", "items": { "$ref": "#/definitions/app.listAppProductsItem" } }, "pageSize": { "type": "integer" }, "total": { "type": "integer" } } }, "app.listCouponUsageResponse": { "type": "object", "properties": { "coupon": { "$ref": "#/definitions/app.couponDetail" }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "records": { "type": "array", "items": { "$ref": "#/definitions/app.couponUsageItem" } }, "total": { "type": "integer" } } }, "app.listCouponsResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/app.couponItem" } }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" } } }, "app.listDrawLogsByLevelResponse": { "type": "object", "properties": { "groups": { "type": "array", "items": { "$ref": "#/definitions/app.drawLogGroup" } } } }, "app.listDrawLogsResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/app.drawLogItem" } }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" } } }, "app.listInventoryResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/user.InventoryWithProduct" } }, "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.listIssueChoicesResponse": { "type": "object", "properties": { "available": { "type": "array", "items": { "type": "integer" } }, "claimed": { "type": "array", "items": { "type": "integer" } }, "total_slots": { "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.listOrdersResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/user.OrderWithItems" } }, "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.listShipmentsResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/user.ShipmentGroup" } }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" } } }, "app.listStoreItem": { "type": "object", "properties": { "discount_type": { "type": "integer" }, "discount_value": { "type": "integer" }, "id": { "type": "integer" }, "in_stock": { "type": "boolean" }, "kind": { "type": "string" }, "main_image": { "type": "string" }, "min_spend": { "type": "integer" }, "name": { "type": "string" }, "price": { "type": "integer" }, "status": { "type": "integer" }, "supported": { "type": "boolean" } } }, "app.listStoreItemsResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/app.listStoreItem" } }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" } } }, "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.matchingGameCheckRequest": { "type": "object", "required": [ "game_id" ], "properties": { "game_id": { "type": "string" }, "total_pairs": { "description": "客户端上报的消除总对数", "type": "integer" } } }, "app.matchingGameCheckResponse": { "type": "object", "properties": { "finished": { "type": "boolean" }, "game_id": { "type": "string" }, "reward": { "$ref": "#/definitions/app.MatchingRewardInfo" }, "total_pairs": { "type": "integer" } } }, "app.matchingGamePreOrderRequest": { "type": "object", "properties": { "coupon_id": { "type": "integer" }, "issue_id": { "type": "integer" }, "item_card_id": { "type": "integer" }, "position": { "type": "string" } } }, "app.matchingGamePreOrderResponse": { "type": "object", "properties": { "all_cards": { "description": "全量99张卡牌（乱序）", "type": "array", "items": { "$ref": "#/definitions/app.MatchingCard" } }, "game_id": { "type": "string" }, "order_no": { "type": "string" }, "pay_status": { "description": "1=Pending, 2=Paid", "type": "integer" }, "server_seed_hash": { "type": "string" } } }, "app.modifyUserRequest": { "type": "object", "properties": { "avatar": { "type": "string" }, "nickname": { "type": "string" } } }, "app.modifyUserResponse": { "type": "object", "properties": { "user": { "$ref": "#/definitions/app.userItem" } } }, "app.okDeleteResponse": { "type": "object", "properties": { "ok": { "type": "boolean" } } }, "app.okResponse": { "type": "object", "properties": { "ok": { "type": "boolean" } } }, "app.orderResultItem": { "type": "object", "properties": { "draw_index": { "type": "integer" }, "level": { "type": "integer" }, "reward_id": { "type": "integer" }, "reward_name": { "type": "string" } } }, "app.orderResultResponse": { "type": "object", "properties": { "completed": { "type": "integer" }, "count": { "type": "integer" }, "draw_mode": { "type": "string" }, "nextPollMs": { "type": "integer" }, "next_draw_time": { "type": "string" }, "receipt": { "type": "object", "additionalProperties": {} }, "results": { "type": "array", "items": { "$ref": "#/definitions/app.orderResultItem" } }, "seed_hex": { "type": "string" }, "status": { "type": "string" } } }, "app.pointsBalanceResponse": { "type": "object", "properties": { "balance": { "type": "integer" } } }, "app.redeemCouponRequest": { "type": "object", "properties": { "coupon_id": { "type": "integer" } } }, "app.redeemCouponResponse": { "type": "object", "properties": { "coupon_id": { "type": "integer" }, "ledger_id": { "type": "integer" }, "message": { "type": "string" }, "success": { "type": "boolean" } } }, "app.redeemInventoryRequest": { "type": "object", "properties": { "inventory_ids": { "type": "array", "items": { "type": "integer" } } } }, "app.redeemInventoryResponse": { "type": "object", "properties": { "points": { "type": "integer" } } }, "app.redeemItemCardRequest": { "type": "object", "properties": { "card_id": { "type": "integer" }, "quantity": { "type": "integer" } } }, "app.redeemItemCardResponse": { "type": "object", "properties": { "card_id": { "type": "integer" }, "ledger_id": { "type": "integer" }, "message": { "type": "string" }, "success": { "type": "boolean" } } }, "app.redeemProductRequest": { "type": "object", "properties": { "product_id": { "type": "integer" }, "quantity": { "type": "integer" } } }, "app.redeemProductResponse": { "type": "object", "properties": { "inventory_ids": { "type": "array", "items": { "type": "integer" } }, "ledger_id": { "type": "integer" }, "message": { "type": "string" }, "order_id": { "type": "integer" }, "success": { "type": "boolean" } } }, "app.requestShippingBatchRequest": { "type": "object", "properties": { "address_id": { "type": "integer" }, "inventory_ids": { "type": "array", "items": { "type": "integer" } } } }, "app.requestShippingBatchResponse": { "type": "object", "properties": { "address_id": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "additionalProperties": {} } }, "skipped": { "type": "array", "items": { "type": "object", "additionalProperties": {} } }, "success_ids": { "type": "array", "items": { "type": "integer" } } } }, "app.requestShippingRequest": { "type": "object", "properties": { "inventory_id": { "type": "integer" } } }, "app.requestShippingResponse": { "type": "object", "properties": { "address_id": { "type": "integer" } } }, "app.resultResponse": { "type": "object", "properties": { "receipt": { "type": "object", "additionalProperties": {} }, "result": { "type": "object", "additionalProperties": {} } } }, "app.rewardItem": { "type": "object", "properties": { "is_boss": { "type": "integer" }, "level": { "type": "integer" }, "name": { "type": "string" }, "original_qty": { "type": "integer" }, "product_id": { "type": "integer" }, "product_image": { "type": "string" }, "quantity": { "type": "integer" }, "sort": { "type": "integer" }, "weight": { "type": "integer" } } }, "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" }, "openid": { "type": "string" }, "token": { "type": "string" }, "user_id": { "type": "integer" } } }, "code.Failure": { "type": "object", "properties": { "code": { "description": "业务码", "type": "integer" }, "message": { "description": "描述信息", "type": "string" } } }, "minesweeper.SettleGameRequest": { "type": "object", "properties": { "match_id": { "type": "string" }, "metadata": { "type": "string" }, "score": { "type": "integer" }, "ticket": { "type": "string" }, "user_id": { "type": "string" }, "win": { "type": "boolean" } } }, "minesweeper.SettleGameResponse": { "type": "object", "properties": { "reward": { "type": "string" }, "success": { "type": "boolean" } } }, "minesweeper.VerifyTicketRequest": { "type": "object", "properties": { "ticket": { "type": "string" }, "user_id": { "type": "string" } } }, "minesweeper.VerifyTicketResponse": { "type": "object", "properties": { "remaining_times": { "type": "integer" }, "user_id": { "type": "string" }, "valid": { "type": "boolean" } } }, "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.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.ShippingRecords": { "type": "object", "properties": { "address_id": { "description": "收货地址ID（user_addresses.id）", "type": "integer" }, "batch_no": { "description": "批次号（批量发货时用于聚合）", "type": "string" }, "created_at": { "description": "创建时间", "type": "string" }, "express_code": { "description": "快递公司编码", "type": "string" }, "express_no": { "description": "运单号", "type": "string" }, "id": { "description": "主键ID", "type": "integer" }, "inventory_id": { "description": "资产ID（抽奖产物发货时使用）", "type": "integer" }, "order_id": { "description": "关联订单ID（orders.id，抽奖产物可为空）", "type": "integer" }, "order_item_id": { "description": "订单行ID（商城直发时使用）", "type": "integer" }, "price": { "description": "行价格（分，可选）", "type": "integer" }, "product_id": { "description": "商品ID（统计/冗余）", "type": "integer" }, "quantity": { "description": "发货数量", "type": "integer" }, "received_at": { "description": "签收时间", "type": "string" }, "remark": { "description": "备注", "type": "string" }, "shipped_at": { "description": "发货时间", "type": "string" }, "status": { "description": "发货状态：1待发货 2已发货 3已签收 4异常", "type": "integer" }, "updated_at": { "description": "更新时间", "type": "string" }, "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" } } }, "pay.notifyAck": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } }, "taskcenter.claimTaskRequest": { "type": "object", "properties": { "tier_id": { "type": "integer" } } }, "taskcenter.createTaskRequest": { "type": "object", "properties": { "description": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "integer" }, "visibility": { "type": "integer" } } }, "taskcenter.listTasksResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/taskcenter.taskItem" } }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" } } }, "taskcenter.modifyTaskRequest": { "type": "object", "properties": { "description": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "integer" }, "visibility": { "type": "integer" } } }, "taskcenter.simulateInviteSuccessRequest": { "type": "object", "properties": { "invitee_id": { "type": "integer" }, "inviter_id": { "type": "integer" } } }, "taskcenter.simulateOrderPaidRequest": { "type": "object", "properties": { "order_id": { "type": "integer" }, "user_id": { "type": "integer" } } }, "taskcenter.taskItem": { "type": "object", "properties": { "description": { "type": "string" }, "end_time": { "type": "integer" }, "id": { "type": "integer" }, "name": { "type": "string" }, "rewards": { "type": "array", "items": { "$ref": "#/definitions/taskcenter.taskRewardItem" } }, "start_time": { "type": "integer" }, "status": { "type": "integer" }, "tiers": { "type": "array", "items": { "$ref": "#/definitions/taskcenter.taskTierItem" } } } }, "taskcenter.taskProgressResponse": { "type": "object", "properties": { "claimed_tiers": { "type": "array", "items": { "type": "integer" } }, "first_order": { "type": "boolean" }, "invite_count": { "type": "integer" }, "order_count": { "type": "integer" }, "task_id": { "type": "integer" }, "user_id": { "type": "integer" } } }, "taskcenter.taskRewardItem": { "type": "object", "properties": { "id": { "type": "integer" }, "quantity": { "type": "integer" }, "reward_payload": { "type": "object", "additionalProperties": {} }, "reward_type": { "type": "string" }, "tier_id": { "type": "integer" } } }, "taskcenter.taskTierItem": { "type": "object", "properties": { "id": { "type": "integer" }, "metric": { "type": "string" }, "operator": { "type": "string" }, "priority": { "type": "integer" }, "repeatable": { "type": "integer" }, "threshold": { "type": "integer" }, "window": { "type": "string" } } }, "taskcenter.upsertRewardsRequest": { "type": "object", "properties": { "rewards": { "type": "array", "items": { "type": "object", "properties": { "quantity": { "type": "integer" }, "reward_payload": { "type": "array", "items": { "type": "integer" } }, "reward_type": { "type": "string" }, "tier_id": { "type": "integer" } } } } } }, "taskcenter.upsertTiersRequest": { "type": "object", "properties": { "tiers": { "type": "array", "items": { "type": "object", "properties": { "metric": { "type": "string" }, "operator": { "type": "string" }, "priority": { "type": "integer" }, "repeatable": { "type": "integer" }, "threshold": { "type": "integer" }, "window": { "type": "string" } } } } } }, "user.DrawReceiptInfo": { "type": "object", "properties": { "algo_version": { "type": "string" }, "client_id": { "type": "integer" }, "client_seed": { "type": "string" }, "draw_id": { "type": "integer" }, "draw_index": { "type": "integer" }, "draw_log_id": { "type": "integer" }, "items_root": { "type": "string" }, "items_snapshot": { "type": "string" }, "nonce": { "type": "integer" }, "rand_proof": { "type": "string" }, "reward_id": { "type": "integer" }, "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" } } }, "user.InventoryWithProduct": { "type": "object", "properties": { "activity_id": { "description": "来源活动ID", "type": "integer" }, "created_at": { "description": "创建时间", "type": "string" }, "has_shipment": { "type": "boolean" }, "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" }, "shipping_status": { "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": { "activity_id": { "type": "integer" }, "activity_name": { "type": "string" }, "actual_amount": { "description": "实际支付金额（分）", "type": "integer" }, "cancelled_at": { "description": "取消时间", "type": "string" }, "category_id": { "type": "integer" }, "category_name": { "type": "string" }, "created_at": { "description": "创建时间", "type": "string" }, "discount_amount": { "description": "优惠券抵扣金额（分）", "type": "integer" }, "draw_receipts": { "type": "array", "items": { "$ref": "#/definitions/user.DrawReceiptInfo" } }, "id": { "description": "主键ID", "type": "integer" }, "is_consumed": { "description": "是否已履约/消耗（对虚拟资产）", "type": "integer" }, "is_draw": { "type": "boolean" }, "is_winner": { "type": "boolean" }, "issue_number": { "type": "string" }, "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" }, "play_type": { "type": "string" }, "points_amount": { "description": "积分抵扣金额（分）", "type": "integer" }, "points_ledger_id": { "description": "积分扣减流水ID（user_points_ledger.id）", "type": "integer" }, "remark": { "description": "备注", "type": "string" }, "reward_level": { "type": "integer" }, "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" } } }, "user.ProductInfo": { "type": "object", "properties": { "id": { "type": "integer" }, "image": { "type": "string" }, "name": { "type": "string" }, "price": { "type": "integer" } } }, "user.ShipmentGroup": { "type": "object", "properties": { "batch_no": { "type": "string" }, "count": { "type": "integer" }, "express_code": { "type": "string" }, "express_no": { "type": "string" }, "inventory_ids": { "type": "array", "items": { "type": "integer" } }, "product_ids": { "type": "array", "items": { "type": "integer" } }, "products": { "type": "array", "items": { "$ref": "#/definitions/user.ProductInfo" } }, "received_at": { "type": "string" }, "shipped_at": { "type": "string" }, "status": { "type": "integer" } } } }, "securityDefinitions": { "LoginVerifyToken": { "type": "apiKey", "name": "Authorization", "in": "header" } } }` // SwaggerInfo holds exported Swagger Info so clients can modify it var SwaggerInfo = &swag.Spec{ Version: "v0.0.1", Host: "", BasePath: "/", Schemes: []string{}, Title: "mini-chat 接口文档", Description: "", InfoInstanceName: "swagger", SwaggerTemplate: docTemplate, LeftDelim: "{{", RightDelim: "}}", } func init() { swag.Register(SwaggerInfo.InstanceName(), SwaggerInfo) }