zfc/bindbox-game
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
bindbox-game/docs/docs.go
邹方成 a7a0f639e1 feat: 新增取消发货功能并优化任务中心 
fix: 修复微信通知字段截断导致的编码错误
feat: 添加有效邀请相关字段和任务中心常量
refactor: 重构一番赏奖品格位逻辑
perf: 优化道具卡列表聚合显示
docs: 更新项目说明文档和API文档
test: 添加字符串截断工具测试
2025-12-23 22:26:07 +08:00

10589 lines
340 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// 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/cancel-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.cancelShippingRequest"
}
}
],
"responses": {
"200": {
"description": "成功",
"schema": {
"$ref": "#/definitions/app.cancelShippingResponse"
}
},
"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.cancelShippingRequest": {
"type": "object",
"properties": {
"inventory_id": {
"type": "integer"
}
}
},
"app.cancelShippingResponse": {
"type": "object"
},
"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)
}
Reference in New Issue View Git Blame Copy Permalink