13162 lines
421 KiB
Go
13162 lines
421 KiB
Go
// 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}/game-passes/check": {
|
||
"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.checkActivityGamePassesResponse"
|
||
}
|
||
},
|
||
"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/game-pass-packages": {
|
||
"get": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "查询次数卡套餐列表",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"管理端.次数卡套餐"
|
||
],
|
||
"summary": "次数卡套餐列表",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "活动ID",
|
||
"name": "activity_id",
|
||
"in": "query"
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "状态: 1=上架 2=下架",
|
||
"name": "status",
|
||
"in": "query"
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "页码",
|
||
"name": "page",
|
||
"in": "query"
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "每页条数",
|
||
"name": "page_size",
|
||
"in": "query"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.listGamePassPackagesResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"post": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "创建可购买的次数卡套餐",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"管理端.次数卡套餐"
|
||
],
|
||
"summary": "创建次数卡套餐",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.createGamePassPackageRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.createGamePassPackageResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/admin/game-pass-packages/{package_id}": {
|
||
"put": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "修改次数卡套餐配置",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"管理端.次数卡套餐"
|
||
],
|
||
"summary": "修改次数卡套餐",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "套餐ID",
|
||
"name": "package_id",
|
||
"in": "path",
|
||
"required": true
|
||
},
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.modifyGamePassPackageRequest"
|
||
}
|
||
}
|
||
],
|
||
"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": "package_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/game-passes/grant": {
|
||
"post": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "管理员为用户发放游戏次数卡",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"管理端.次数卡"
|
||
],
|
||
"summary": "发放次数卡",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.grantGamePassRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.grantGamePassResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/admin/game-passes/list": {
|
||
"get": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "查询用户次数卡列表，支持按用户、活动过滤",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"管理端.次数卡"
|
||
],
|
||
"summary": "次数卡列表",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "用户ID",
|
||
"name": "user_id",
|
||
"in": "query"
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "活动ID",
|
||
"name": "activity_id",
|
||
"in": "query"
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "页码",
|
||
"name": "page",
|
||
"in": "query"
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "每页条数",
|
||
"name": "page_size",
|
||
"in": "query"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.listGamePassesResponse"
|
||
}
|
||
},
|
||
"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/audit/{order_no}": {
|
||
"get": {
|
||
"security": [
|
||
{
|
||
"AdminAuth": []
|
||
}
|
||
],
|
||
"description": "运营通过单号查询发牌过程",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"管理端.对对碰"
|
||
],
|
||
"summary": "获取对对碰审计数据",
|
||
"parameters": [
|
||
{
|
||
"type": "string",
|
||
"description": "订单号",
|
||
"name": "order_no",
|
||
"in": "path",
|
||
"required": true
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/activity.MatchingGame"
|
||
}
|
||
},
|
||
"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/orders/{order_id}/rollback": {
|
||
"post": {
|
||
"description": "基于快照将用户数据回滚到消费前状态，包括恢复积分、优惠券、道具卡，作废资产，调用微信退款",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"Admin-Audit"
|
||
],
|
||
"summary": "回滚订单到消费前状态",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "订单ID",
|
||
"name": "order_id",
|
||
"in": "path",
|
||
"required": true
|
||
},
|
||
{
|
||
"description": "回滚请求",
|
||
"name": "request",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.rollbackOrderRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.rollbackOrderResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/admin/orders/{order_id}/snapshots": {
|
||
"get": {
|
||
"description": "获取订单消费前后的完整用户状态快照",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"Admin-Audit"
|
||
],
|
||
"summary": "获取订单审计快照",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "订单ID",
|
||
"name": "order_id",
|
||
"in": "path",
|
||
"required": true
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.getOrderSnapshotsResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/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}/game-passes": {
|
||
"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.getUserGamePassesResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/admin/users/{user_id}/game_tickets": {
|
||
"get": {
|
||
"tags": [
|
||
"管理端.游戏"
|
||
],
|
||
"summary": "查询用户游戏资格日志",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "用户ID",
|
||
"name": "user_id",
|
||
"in": "path",
|
||
"required": true
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "页码",
|
||
"name": "page",
|
||
"in": "query"
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "每页数量",
|
||
"name": "page_size",
|
||
"in": "query"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"type": "object",
|
||
"additionalProperties": true
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"post": {
|
||
"tags": [
|
||
"管理端.游戏"
|
||
],
|
||
"summary": "发放游戏资格",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "用户ID",
|
||
"name": "user_id",
|
||
"in": "path",
|
||
"required": true
|
||
},
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/game.grantTicketRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"type": "object",
|
||
"additionalProperties": true
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/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}/profile": {
|
||
"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.UserProfileResponse"
|
||
}
|
||
},
|
||
"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/game-passes/available": {
|
||
"get": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "查询当前用户可用的游戏次数卡",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "获取用户次数卡",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "活动ID，不传返回所有可用次数卡",
|
||
"name": "activity_id",
|
||
"in": "query"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.getGamePassesResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/game-passes/packages": {
|
||
"get": {
|
||
"description": "获取可购买的次数卡套餐列表",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "获取次数卡套餐",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "活动ID，不传返回全局套餐",
|
||
"name": "activity_id",
|
||
"in": "query"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.getPackagesResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/game-passes/purchase": {
|
||
"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.purchasePackageRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.purchasePackageResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/games/enter": {
|
||
"post": {
|
||
"tags": [
|
||
"APP端.游戏"
|
||
],
|
||
"summary": "进入游戏",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/game.enterGameRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/game.enterGameResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/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/activity.CardTypeConfig"
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/matching/cards": {
|
||
"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": {
|
||
"$ref": "#/definitions/app.matchingGameCardsResponse"
|
||
}
|
||
},
|
||
"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/sms/login": {
|
||
"post": {
|
||
"description": "使用短信验证码登录或注册（新手机号自动创建账户）",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "短信验证码登录",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/app.smsLoginRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.smsLoginResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/sms/send-code": {
|
||
"post": {
|
||
"description": "发送短信验证码到指定手机号（60秒内不可重复发送，每日最多10次）",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "发送短信验证码",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/app.sendSmsCodeRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.sendSmsCodeResponse"
|
||
}
|
||
},
|
||
"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/douyin/login": {
|
||
"post": {
|
||
"description": "抖音小程序登录（需传递 code 或 anonymous_code）",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "抖音登录",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/app.douyinLoginRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.douyinLoginResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/users/profile": {
|
||
"get": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "获取当前登录用户的详细信息",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "获取用户信息",
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.userItem"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/users/weixin/login": {
|
||
"post": {
|
||
"description": "微信静默登录（需传递 code；可选 invite_code）",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "微信登录",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/app.weixinLoginRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.weixinLoginResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/users/{user_id}": {
|
||
"put": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "修改用户昵称与头像",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "修改用户信息",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "用户ID",
|
||
"name": "user_id",
|
||
"in": "path",
|
||
"required": true
|
||
},
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/app.modifyUserRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.modifyUserResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/users/{user_id}/addresses": {
|
||
"get": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "分页获取当前登录用户的收货地址列表，默认地址优先",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "获取用户地址列表",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "用户ID",
|
||
"name": "user_id",
|
||
"in": "path",
|
||
"required": true
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "页码，默认1",
|
||
"name": "page",
|
||
"in": "query"
|
||
},
|
||
{
|
||
"type": "integer",
|
||
"description": "每页条数，默认20，最多100",
|
||
"name": "page_size",
|
||
"in": "query"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.listAddressesResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "参数错误",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
},
|
||
"401": {
|
||
"description": "未授权",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"post": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "为当前登录用户新增收货地址，可选择设为默认",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"APP端.用户"
|
||
],
|
||
"summary": "新增用户地址",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "用户ID",
|
||
"name": "user_id",
|
||
"in": "path",
|
||
"required": true
|
||
},
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/app.addAddressRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.addAddressResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "参数错误",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
},
|
||
"401": {
|
||
"description": "未授权",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/users/{user_id}/addresses/{address_id}": {
|
||
"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
|
||
},
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/app.updateAddressRequest"
|
||
}
|
||
}
|
||
],
|
||
"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"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"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}/douyin/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.bindDouyinPhoneRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/app.bindDouyinPhoneResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/app/users/{user_id}/game_tickets": {
|
||
"get": {
|
||
"tags": [
|
||
"APP端.游戏"
|
||
],
|
||
"summary": "获取我的游戏资格",
|
||
"parameters": [
|
||
{
|
||
"type": "integer",
|
||
"description": "用户ID",
|
||
"name": "user_id",
|
||
"in": "path",
|
||
"required": true
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"type": "object",
|
||
"additionalProperties": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/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": "取消已提交但未发货的申请；恢复库存状态。支持按单个资产ID取消或按批次号批量取消",
|
||
"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积分=1元（券面值为分）",
|
||
"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积分=1元兑换商品，生成系统发放订单与用户资产",
|
||
"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": {
|
||
"post": {
|
||
"security": [
|
||
{
|
||
"LoginVerifyToken": []
|
||
}
|
||
],
|
||
"description": "创建新的管理员账号",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"application/json"
|
||
],
|
||
"tags": [
|
||
"管理端.系统"
|
||
],
|
||
"summary": "创建系统用户",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.createUserRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/admin.createUserResponse"
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "Bad Request",
|
||
"schema": {
|
||
"$ref": "#/definitions/code.Failure"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/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/consume-ticket": {
|
||
"post": {
|
||
"tags": [
|
||
"Internal.游戏"
|
||
],
|
||
"summary": "扣减游戏次数",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/game.consumeTicketRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/game.consumeTicketResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/internal/game/minesweeper/config": {
|
||
"get": {
|
||
"tags": [
|
||
"Internal.游戏"
|
||
],
|
||
"summary": "获取扫雷配置",
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"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/validate-token": {
|
||
"post": {
|
||
"tags": [
|
||
"Internal.游戏"
|
||
],
|
||
"summary": "验证GameToken",
|
||
"parameters": [
|
||
{
|
||
"description": "请求参数",
|
||
"name": "RequestBody",
|
||
"in": "body",
|
||
"required": true,
|
||
"schema": {
|
||
"$ref": "#/definitions/game.validateTokenRequest"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/game.validateTokenResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/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": {
|
||
"activity.CardTypeConfig": {
|
||
"type": "object",
|
||
"properties": {
|
||
"code": {
|
||
"type": "string"
|
||
},
|
||
"image_url": {
|
||
"type": "string"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"quantity": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"activity.MatchingCard": {
|
||
"type": "object",
|
||
"properties": {
|
||
"id": {
|
||
"type": "string"
|
||
},
|
||
"type": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"activity.MatchingGame": {
|
||
"type": "object",
|
||
"properties": {
|
||
"activity_id": {
|
||
"type": "integer"
|
||
},
|
||
"board": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/activity.MatchingCard"
|
||
}
|
||
},
|
||
"card_configs": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/activity.CardTypeConfig"
|
||
}
|
||
},
|
||
"card_id_counter": {
|
||
"type": "integer"
|
||
},
|
||
"created_at": {
|
||
"description": "游戏创建时间，用于自动开奖超时判断",
|
||
"type": "string"
|
||
},
|
||
"deck": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/activity.MatchingCard"
|
||
}
|
||
},
|
||
"issue_id": {
|
||
"type": "integer"
|
||
},
|
||
"last_activity": {
|
||
"type": "string"
|
||
},
|
||
"max_possible_pairs": {
|
||
"type": "integer"
|
||
},
|
||
"nonce": {
|
||
"type": "integer"
|
||
},
|
||
"order_id": {
|
||
"type": "integer"
|
||
},
|
||
"position": {
|
||
"description": "用户选择的类型，用于服务端验证",
|
||
"type": "string"
|
||
},
|
||
"server_seed": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"server_seed_hash": {
|
||
"type": "string"
|
||
},
|
||
"total_pairs": {
|
||
"type": "integer"
|
||
},
|
||
"user_id": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"admin.GrantRewardRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"product_id"
|
||
],
|
||
"properties": {
|
||
"activity_id": {
|
||
"description": "活动ID（可选）",
|
||
"type": "integer"
|
||
},
|
||
"address_id": {
|
||
"description": "收货地址ID（可选，实物商品需要）",
|
||
"type": "integer"
|
||
},
|
||
"points_amount": {
|
||
"description": "消耗积分",
|
||
"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.UserProfileResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"avatar": {
|
||
"type": "string"
|
||
},
|
||
"channel_id": {
|
||
"type": "integer"
|
||
},
|
||
"created_at": {
|
||
"type": "string"
|
||
},
|
||
"current_assets": {
|
||
"description": "当前资产快照",
|
||
"type": "object",
|
||
"properties": {
|
||
"coupon_count": {
|
||
"description": "持有优惠券数",
|
||
"type": "integer"
|
||
},
|
||
"coupon_value": {
|
||
"description": "持有优惠券价值",
|
||
"type": "integer"
|
||
},
|
||
"inventory_count": {
|
||
"description": "持有商品数",
|
||
"type": "integer"
|
||
},
|
||
"inventory_value": {
|
||
"description": "持有商品价值",
|
||
"type": "integer"
|
||
},
|
||
"item_card_count": {
|
||
"description": "持有道具卡数",
|
||
"type": "integer"
|
||
},
|
||
"item_card_value": {
|
||
"description": "持有道具卡价值",
|
||
"type": "integer"
|
||
},
|
||
"points_balance": {
|
||
"description": "积分余额",
|
||
"type": "integer"
|
||
},
|
||
"profit_loss_ratio": {
|
||
"description": "累计盈亏比",
|
||
"type": "number"
|
||
},
|
||
"total_asset_value": {
|
||
"description": "总资产估值",
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"douyin_id": {
|
||
"type": "string"
|
||
},
|
||
"id": {
|
||
"description": "基本信息",
|
||
"type": "integer"
|
||
},
|
||
"invite_code": {
|
||
"type": "string"
|
||
},
|
||
"invite_count": {
|
||
"description": "邀请统计",
|
||
"type": "integer"
|
||
},
|
||
"inviter_id": {
|
||
"type": "integer"
|
||
},
|
||
"lifetime_stats": {
|
||
"description": "生命周期财务指标",
|
||
"type": "object",
|
||
"properties": {
|
||
"net_cash_cost": {
|
||
"description": "净现金支出",
|
||
"type": "integer"
|
||
},
|
||
"order_count": {
|
||
"description": "订单数",
|
||
"type": "integer"
|
||
},
|
||
"total_paid": {
|
||
"description": "累计支付",
|
||
"type": "integer"
|
||
},
|
||
"total_refunded": {
|
||
"description": "累计退款",
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"mobile": {
|
||
"type": "string"
|
||
},
|
||
"nickname": {
|
||
"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",
|
||
"properties": {
|
||
"kind": {
|
||
"type": "string"
|
||
},
|
||
"points": {
|
||
"description": "正数=增加，负数=扣减",
|
||
"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"
|
||
},
|
||
"points_balance": {
|
||
"type": "integer"
|
||
},
|
||
"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": "number",
|
||
"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.checkActivityGamePassesResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"activity_id": {
|
||
"type": "integer"
|
||
},
|
||
"can_delete": {
|
||
"type": "boolean"
|
||
},
|
||
"message": {
|
||
"type": "string"
|
||
},
|
||
"total_remaining": {
|
||
"type": "integer"
|
||
},
|
||
"user_count": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"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.createGamePassPackageRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"name",
|
||
"pass_count",
|
||
"price"
|
||
],
|
||
"properties": {
|
||
"activity_id": {
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"original_price": {
|
||
"type": "integer"
|
||
},
|
||
"pass_count": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"price": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"sort_order": {
|
||
"type": "integer"
|
||
},
|
||
"status": {
|
||
"description": "1=上架 2=下架",
|
||
"type": "integer"
|
||
},
|
||
"valid_days": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"admin.createGamePassPackageResponse": {
|
||
"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"
|
||
},
|
||
"description": {
|
||
"type": "string"
|
||
},
|
||
"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.createUserRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"password",
|
||
"username"
|
||
],
|
||
"properties": {
|
||
"avatar": {
|
||
"type": "string"
|
||
},
|
||
"mobile": {
|
||
"type": "string"
|
||
},
|
||
"nickname": {
|
||
"type": "string"
|
||
},
|
||
"password": {
|
||
"type": "string"
|
||
},
|
||
"username": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"admin.createUserResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"message": {
|
||
"type": "string"
|
||
},
|
||
"success": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"admin.gamePassItem": {
|
||
"type": "object",
|
||
"properties": {
|
||
"activity_id": {
|
||
"type": "integer"
|
||
},
|
||
"activity_name": {
|
||
"type": "string"
|
||
},
|
||
"created_at": {
|
||
"type": "string"
|
||
},
|
||
"expired_at": {
|
||
"type": "string"
|
||
},
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"remaining": {
|
||
"type": "integer"
|
||
},
|
||
"remark": {
|
||
"type": "string"
|
||
},
|
||
"source": {
|
||
"type": "string"
|
||
},
|
||
"total_granted": {
|
||
"type": "integer"
|
||
},
|
||
"total_used": {
|
||
"type": "integer"
|
||
},
|
||
"user_id": {
|
||
"type": "integer"
|
||
},
|
||
"user_name": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"admin.gamePassPackageItem": {
|
||
"type": "object",
|
||
"properties": {
|
||
"activity_id": {
|
||
"type": "integer"
|
||
},
|
||
"activity_name": {
|
||
"type": "string"
|
||
},
|
||
"created_at": {
|
||
"type": "string"
|
||
},
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"original_price": {
|
||
"type": "integer"
|
||
},
|
||
"pass_count": {
|
||
"type": "integer"
|
||
},
|
||
"price": {
|
||
"type": "integer"
|
||
},
|
||
"sort_order": {
|
||
"type": "integer"
|
||
},
|
||
"status": {
|
||
"type": "integer"
|
||
},
|
||
"valid_days": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"admin.getOrderSnapshotsResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"after_snapshot": {
|
||
"$ref": "#/definitions/snapshot.UserStateSnapshot"
|
||
},
|
||
"before_snapshot": {
|
||
"$ref": "#/definitions/snapshot.UserStateSnapshot"
|
||
},
|
||
"diff": {
|
||
"$ref": "#/definitions/snapshot.SnapshotDiff"
|
||
},
|
||
"has_snapshots": {
|
||
"type": "boolean"
|
||
},
|
||
"order": {
|
||
"type": "object",
|
||
"properties": {
|
||
"actual_amount": {
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"order_no": {
|
||
"type": "string"
|
||
},
|
||
"paid_at": {
|
||
"type": "string"
|
||
},
|
||
"status": {
|
||
"type": "integer"
|
||
},
|
||
"user_id": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"admin.getUserGamePassesResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"activity_passes": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/admin.gamePassItem"
|
||
}
|
||
},
|
||
"global_remaining": {
|
||
"type": "integer"
|
||
},
|
||
"total_remaining": {
|
||
"type": "integer"
|
||
},
|
||
"user_id": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"admin.grantGamePassRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"count",
|
||
"user_id"
|
||
],
|
||
"properties": {
|
||
"activity_id": {
|
||
"description": "可选，NULL表示全局通用",
|
||
"type": "integer"
|
||
},
|
||
"count": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"remark": {
|
||
"type": "string"
|
||
},
|
||
"user_id": {
|
||
"type": "integer"
|
||
},
|
||
"valid_days": {
|
||
"description": "可选，NULL表示永久有效",
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"admin.grantGamePassResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"message": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"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.listGamePassPackagesResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"list": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/admin.gamePassPackageItem"
|
||
}
|
||
},
|
||
"page": {
|
||
"type": "integer"
|
||
},
|
||
"page_size": {
|
||
"type": "integer"
|
||
},
|
||
"total": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"admin.listGamePassesResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"list": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/admin.gamePassItem"
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"force": {
|
||
"type": "boolean"
|
||
},
|
||
"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.modifyGamePassPackageRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"activity_id": {
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"original_price": {
|
||
"type": "integer"
|
||
},
|
||
"pass_count": {
|
||
"type": "integer"
|
||
},
|
||
"price": {
|
||
"type": "integer"
|
||
},
|
||
"sort_order": {
|
||
"type": "integer"
|
||
},
|
||
"status": {
|
||
"type": "integer"
|
||
},
|
||
"valid_days": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"description": {
|
||
"type": "string"
|
||
},
|
||
"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"
|
||
},
|
||
"original_qty": {
|
||
"type": "integer"
|
||
},
|
||
"product_id": {
|
||
"type": "integer"
|
||
},
|
||
"quantity": {
|
||
"type": "integer"
|
||
},
|
||
"sort": {
|
||
"type": "integer"
|
||
},
|
||
"weight": {
|
||
"type": "number"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"description": {
|
||
"type": "string"
|
||
},
|
||
"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",
|
||
"original_qty",
|
||
"quantity",
|
||
"weight"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"is_boss": {
|
||
"type": "integer"
|
||
},
|
||
"level": {
|
||
"type": "integer"
|
||
},
|
||
"min_score": {
|
||
"type": "integer"
|
||
},
|
||
"original_qty": {
|
||
"type": "integer"
|
||
},
|
||
"product_id": {
|
||
"type": "integer"
|
||
},
|
||
"product_image_url": {
|
||
"type": "string"
|
||
},
|
||
"product_name": {
|
||
"type": "string"
|
||
},
|
||
"product_price": {
|
||
"type": "number"
|
||
},
|
||
"quantity": {
|
||
"type": "integer"
|
||
},
|
||
"sort": {
|
||
"type": "integer"
|
||
},
|
||
"weight": {
|
||
"type": "number"
|
||
}
|
||
}
|
||
},
|
||
"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.rollbackOrderRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"confirm": {
|
||
"type": "boolean"
|
||
},
|
||
"reason": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"admin.rollbackOrderResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"coupons_restored": {
|
||
"type": "integer"
|
||
},
|
||
"error_msg": {
|
||
"type": "string"
|
||
},
|
||
"inventory_revoked": {
|
||
"type": "integer"
|
||
},
|
||
"item_cards_restored": {
|
||
"type": "integer"
|
||
},
|
||
"points_restored": {
|
||
"type": "integer"
|
||
},
|
||
"refund_amount": {
|
||
"type": "integer"
|
||
},
|
||
"rollback_log_id": {
|
||
"type": "integer"
|
||
},
|
||
"success": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"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.MatchingRewardInfo": {
|
||
"type": "object",
|
||
"properties": {
|
||
"level": {
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"product_image": {
|
||
"description": "商品图片",
|
||
"type": "string"
|
||
},
|
||
"product_name": {
|
||
"description": "商品原始名称",
|
||
"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"
|
||
},
|
||
"short_link": {
|
||
"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.bindDouyinPhoneRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"code": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"app.bindDouyinPhoneResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"mobile": {
|
||
"type": "string"
|
||
},
|
||
"success": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"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": {
|
||
"batch_no": {
|
||
"description": "批次号（与inventory_id二选一，取消整批）",
|
||
"type": "string"
|
||
},
|
||
"inventory_id": {
|
||
"description": "单个资产ID（与batch_no二选一）",
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.cancelShippingResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"cancelled_count": {
|
||
"description": "成功取消的数量",
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.couponDetail": {
|
||
"type": "object",
|
||
"properties": {
|
||
"amount": {
|
||
"description": "原始面值",
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"remaining": {
|
||
"description": "剩余额度",
|
||
"type": "integer"
|
||
},
|
||
"status": {
|
||
"type": "integer"
|
||
},
|
||
"use_count": {
|
||
"description": "使用次数",
|
||
"type": "integer"
|
||
},
|
||
"used_amount": {
|
||
"description": "累计已使用金额",
|
||
"type": "integer"
|
||
},
|
||
"valid_end": {
|
||
"type": "string"
|
||
},
|
||
"valid_start": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"app.couponItem": {
|
||
"type": "object",
|
||
"properties": {
|
||
"amount": {
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"remaining": {
|
||
"type": "integer"
|
||
},
|
||
"rules": {
|
||
"type": "string"
|
||
},
|
||
"status": {
|
||
"type": "integer"
|
||
},
|
||
"used_at": {
|
||
"description": "使用时间（已使用时返回）",
|
||
"type": "string"
|
||
},
|
||
"valid_end": {
|
||
"type": "string"
|
||
},
|
||
"valid_start": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"app.couponStatsResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"expired_count": {
|
||
"description": "已过期优惠券数量",
|
||
"type": "integer"
|
||
},
|
||
"total_remaining": {
|
||
"description": "可用优惠券总余额（分）",
|
||
"type": "integer"
|
||
},
|
||
"total_saved": {
|
||
"description": "累计节省金额（分）",
|
||
"type": "integer"
|
||
},
|
||
"unused_count": {
|
||
"description": "可用优惠券数量",
|
||
"type": "integer"
|
||
},
|
||
"used_count": {
|
||
"description": "已使用优惠券数量",
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.couponUsageItem": {
|
||
"type": "object",
|
||
"properties": {
|
||
"activity_name": {
|
||
"description": "活动名称",
|
||
"type": "string"
|
||
},
|
||
"amount": {
|
||
"description": "本次使用金额（正数）",
|
||
"type": "integer"
|
||
},
|
||
"created_at": {
|
||
"type": "string"
|
||
},
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"order_no": {
|
||
"description": "订单号",
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"app.douyinLoginRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"anonymous_code": {
|
||
"type": "string"
|
||
},
|
||
"channel_code": {
|
||
"type": "string"
|
||
},
|
||
"code": {
|
||
"type": "string"
|
||
},
|
||
"invite_code": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"app.douyinLoginResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"avatar": {
|
||
"type": "string"
|
||
},
|
||
"invite_code": {
|
||
"type": "string"
|
||
},
|
||
"nickname": {
|
||
"type": "string"
|
||
},
|
||
"token": {
|
||
"type": "string"
|
||
},
|
||
"user_id": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"created_at": {
|
||
"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"
|
||
},
|
||
"points_required": {
|
||
"type": "integer"
|
||
},
|
||
"price": {
|
||
"type": "integer"
|
||
},
|
||
"recommendations": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/app.listAppProductsItem"
|
||
}
|
||
},
|
||
"sales": {
|
||
"type": "integer"
|
||
},
|
||
"service": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"stock": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.getGamePassesResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"global_remaining": {
|
||
"description": "全局通用次数",
|
||
"type": "integer"
|
||
},
|
||
"passes": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/app.userGamePassItem"
|
||
}
|
||
},
|
||
"total_remaining": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.getPackagesResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"packages": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/app.packageItem"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"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_game_pass": {
|
||
"type": "boolean"
|
||
},
|
||
"use_points": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.joinLotteryResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"actual_amount": {
|
||
"type": "integer"
|
||
},
|
||
"draw_mode": {
|
||
"type": "string"
|
||
},
|
||
"join_id": {
|
||
"type": "string"
|
||
},
|
||
"order_no": {
|
||
"type": "string"
|
||
},
|
||
"queued": {
|
||
"type": "boolean"
|
||
},
|
||
"reward_id": {
|
||
"type": "integer"
|
||
},
|
||
"reward_name": {
|
||
"type": "string"
|
||
},
|
||
"status": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"points_required": {
|
||
"type": "integer"
|
||
},
|
||
"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.AggregatedInventory"
|
||
}
|
||
},
|
||
"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"
|
||
}
|
||
},
|
||
"play_type": {
|
||
"description": "活动类型",
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"points_required": {
|
||
"type": "integer"
|
||
},
|
||
"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.matchingGameCardsResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"all_cards": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/activity.MatchingCard"
|
||
}
|
||
},
|
||
"game_id": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"use_game_pass": {
|
||
"description": "新增：是否使用次数卡",
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"app.matchingGamePreOrderResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"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"
|
||
},
|
||
"image": {
|
||
"type": "string"
|
||
},
|
||
"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.packageItem": {
|
||
"type": "object",
|
||
"properties": {
|
||
"activity_id": {
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"original_price": {
|
||
"type": "integer"
|
||
},
|
||
"pass_count": {
|
||
"type": "integer"
|
||
},
|
||
"price": {
|
||
"type": "integer"
|
||
},
|
||
"valid_days": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.pointsBalanceResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"balance": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.purchasePackageRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"package_id"
|
||
],
|
||
"properties": {
|
||
"count": {
|
||
"description": "购买数量",
|
||
"type": "integer"
|
||
},
|
||
"package_id": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.purchasePackageResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"message": {
|
||
"type": "string"
|
||
},
|
||
"order_no": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"batch_no": {
|
||
"type": "string"
|
||
},
|
||
"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": {}
|
||
},
|
||
"results": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "object",
|
||
"additionalProperties": {}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"app.rewardItem": {
|
||
"type": "object",
|
||
"properties": {
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"is_boss": {
|
||
"type": "integer"
|
||
},
|
||
"level": {
|
||
"type": "integer"
|
||
},
|
||
"min_score": {
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"original_qty": {
|
||
"type": "integer"
|
||
},
|
||
"prize_level": {
|
||
"description": "兼容部分前端逻辑",
|
||
"type": "integer"
|
||
},
|
||
"product_id": {
|
||
"type": "integer"
|
||
},
|
||
"product_image": {
|
||
"type": "string"
|
||
},
|
||
"quantity": {
|
||
"type": "integer"
|
||
},
|
||
"sort": {
|
||
"type": "integer"
|
||
},
|
||
"weight": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.sendSmsCodeRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"mobile"
|
||
],
|
||
"properties": {
|
||
"mobile": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"app.sendSmsCodeResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"expire_seconds": {
|
||
"type": "integer"
|
||
},
|
||
"success": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"app.smsLoginRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"code",
|
||
"mobile"
|
||
],
|
||
"properties": {
|
||
"code": {
|
||
"type": "string"
|
||
},
|
||
"invite_code": {
|
||
"type": "string"
|
||
},
|
||
"mobile": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"app.smsLoginResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"avatar": {
|
||
"type": "string"
|
||
},
|
||
"invite_code": {
|
||
"type": "string"
|
||
},
|
||
"is_new_user": {
|
||
"type": "boolean"
|
||
},
|
||
"mobile": {
|
||
"type": "string"
|
||
},
|
||
"nickname": {
|
||
"type": "string"
|
||
},
|
||
"openid": {
|
||
"type": "string"
|
||
},
|
||
"token": {
|
||
"type": "string"
|
||
},
|
||
"user_id": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"app.updateAddressRequest": {
|
||
"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.userGamePassItem": {
|
||
"type": "object",
|
||
"properties": {
|
||
"activity_id": {
|
||
"type": "integer"
|
||
},
|
||
"activity_name": {
|
||
"type": "string"
|
||
},
|
||
"expired_at": {
|
||
"type": "string"
|
||
},
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"remaining": {
|
||
"type": "integer"
|
||
},
|
||
"source": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"app.userItem": {
|
||
"type": "object",
|
||
"properties": {
|
||
"avatar": {
|
||
"type": "string"
|
||
},
|
||
"balance": {
|
||
"description": "Points",
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"invite_code": {
|
||
"type": "string"
|
||
},
|
||
"inviter_id": {
|
||
"type": "integer"
|
||
},
|
||
"mobile": {
|
||
"type": "string"
|
||
},
|
||
"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"
|
||
}
|
||
}
|
||
},
|
||
"game.consumeTicketRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"game_code": {
|
||
"type": "string"
|
||
},
|
||
"ticket": {
|
||
"type": "string"
|
||
},
|
||
"user_id": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"game.consumeTicketResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"error": {
|
||
"type": "string"
|
||
},
|
||
"success": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"game.enterGameRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"game_code"
|
||
],
|
||
"properties": {
|
||
"game_code": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"game.enterGameResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"client_url": {
|
||
"type": "string"
|
||
},
|
||
"expires_at": {
|
||
"type": "string"
|
||
},
|
||
"game_token": {
|
||
"type": "string"
|
||
},
|
||
"nakama_key": {
|
||
"type": "string"
|
||
},
|
||
"nakama_server": {
|
||
"type": "string"
|
||
},
|
||
"remaining_times": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"game.grantTicketRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"amount",
|
||
"game_code"
|
||
],
|
||
"properties": {
|
||
"amount": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"game_code": {
|
||
"type": "string"
|
||
},
|
||
"remark": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"game.settleRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"match_id": {
|
||
"type": "string"
|
||
},
|
||
"score": {
|
||
"type": "integer"
|
||
},
|
||
"ticket": {
|
||
"type": "string"
|
||
},
|
||
"user_id": {
|
||
"type": "string"
|
||
},
|
||
"win": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"game.settleResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"reward": {
|
||
"type": "string"
|
||
},
|
||
"success": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"game.validateTokenRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"game_token"
|
||
],
|
||
"properties": {
|
||
"game_token": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"game.validateTokenResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"avatar": {
|
||
"type": "string"
|
||
},
|
||
"error": {
|
||
"type": "string"
|
||
},
|
||
"game_type": {
|
||
"type": "string"
|
||
},
|
||
"ticket": {
|
||
"type": "string"
|
||
},
|
||
"user_id": {
|
||
"type": "integer"
|
||
},
|
||
"username": {
|
||
"type": "string"
|
||
},
|
||
"valid": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"game.verifyRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ticket": {
|
||
"type": "string"
|
||
},
|
||
"user_id": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"game.verifyResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"game_config": {
|
||
"type": "object",
|
||
"additionalProperties": {}
|
||
},
|
||
"user_id": {
|
||
"type": "string"
|
||
},
|
||
"valid": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
}
|
||
}
|
||
},
|
||
"snapshot.CouponInfo": {
|
||
"type": "object",
|
||
"properties": {
|
||
"balance_amount": {
|
||
"type": "integer"
|
||
},
|
||
"coupon_id": {
|
||
"type": "integer"
|
||
},
|
||
"coupon_name": {
|
||
"type": "string"
|
||
},
|
||
"status": {
|
||
"type": "integer"
|
||
},
|
||
"user_coupon_id": {
|
||
"type": "integer"
|
||
},
|
||
"valid_end": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"snapshot.ItemCardInfo": {
|
||
"type": "object",
|
||
"properties": {
|
||
"card_id": {
|
||
"type": "integer"
|
||
},
|
||
"card_name": {
|
||
"type": "string"
|
||
},
|
||
"status": {
|
||
"type": "integer"
|
||
},
|
||
"user_item_card_id": {
|
||
"type": "integer"
|
||
},
|
||
"valid_end": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"snapshot.PointsInfo": {
|
||
"type": "object",
|
||
"properties": {
|
||
"balance": {
|
||
"type": "integer"
|
||
},
|
||
"version": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"snapshot.SnapshotDiff": {
|
||
"type": "object",
|
||
"properties": {
|
||
"coupons_used": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/snapshot.CouponInfo"
|
||
}
|
||
},
|
||
"inventory_added": {
|
||
"type": "integer"
|
||
},
|
||
"item_cards_used": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/snapshot.ItemCardInfo"
|
||
}
|
||
},
|
||
"points_changed": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"snapshot.UserInfo": {
|
||
"type": "object",
|
||
"properties": {
|
||
"id": {
|
||
"type": "integer"
|
||
},
|
||
"mobile": {
|
||
"type": "string"
|
||
},
|
||
"nickname": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"snapshot.UserStateSnapshot": {
|
||
"type": "object",
|
||
"properties": {
|
||
"coupons": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/snapshot.CouponInfo"
|
||
}
|
||
},
|
||
"inventory_count": {
|
||
"type": "integer"
|
||
},
|
||
"item_cards": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/snapshot.ItemCardInfo"
|
||
}
|
||
},
|
||
"points": {
|
||
"$ref": "#/definitions/snapshot.PointsInfo"
|
||
},
|
||
"snapshot_time": {
|
||
"type": "string"
|
||
},
|
||
"user": {
|
||
"$ref": "#/definitions/snapshot.UserInfo"
|
||
}
|
||
}
|
||
},
|
||
"taskcenter.claimTaskRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"tier_id": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"taskcenter.createTaskRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"description": {
|
||
"type": "string"
|
||
},
|
||
"end_time": {
|
||
"type": "string"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"start_time": {
|
||
"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"
|
||
},
|
||
"end_time": {
|
||
"type": "string"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"start_time": {
|
||
"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_amount": {
|
||
"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_name": {
|
||
"type": "string"
|
||
},
|
||
"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": {
|
||
"activity_id": {
|
||
"type": "integer"
|
||
},
|
||
"extra_params": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"metric": {
|
||
"type": "string"
|
||
},
|
||
"operator": {
|
||
"type": "string"
|
||
},
|
||
"priority": {
|
||
"type": "integer"
|
||
},
|
||
"repeatable": {
|
||
"type": "integer"
|
||
},
|
||
"threshold": {
|
||
"type": "integer"
|
||
},
|
||
"window": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"user.AggregatedInventory": {
|
||
"type": "object",
|
||
"properties": {
|
||
"count": {
|
||
"type": "integer"
|
||
},
|
||
"has_shipment": {
|
||
"type": "boolean"
|
||
},
|
||
"inventory_ids": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"product_id": {
|
||
"type": "integer"
|
||
},
|
||
"product_images": {
|
||
"type": "string"
|
||
},
|
||
"product_name": {
|
||
"type": "string"
|
||
},
|
||
"product_price": {
|
||
"type": "integer"
|
||
},
|
||
"shipping_status": {
|
||
"type": "integer"
|
||
},
|
||
"status": {
|
||
"description": "用于区分 1持有 3已处理",
|
||
"type": "integer"
|
||
},
|
||
"updated_at": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"user.CouponSimpleInfo": {
|
||
"type": "object",
|
||
"properties": {
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"type": {
|
||
"description": "1:满减 2:折扣",
|
||
"type": "integer"
|
||
},
|
||
"user_coupon_id": {
|
||
"type": "integer"
|
||
},
|
||
"value": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"product_price": {
|
||
"description": "新增价格字段",
|
||
"type": "integer"
|
||
},
|
||
"remark": {
|
||
"description": "备注",
|
||
"type": "string"
|
||
},
|
||
"reward_id": {
|
||
"description": "来源奖励ID（activity_reward_settings.id）",
|
||
"type": "integer"
|
||
},
|
||
"shipping_no": {
|
||
"description": "发货单号",
|
||
"type": "string"
|
||
},
|
||
"shipping_status": {
|
||
"type": "integer"
|
||
},
|
||
"status": {
|
||
"description": "状态：1持有 2作废 3已使用/发货",
|
||
"type": "integer"
|
||
},
|
||
"updated_at": {
|
||
"description": "更新时间",
|
||
"type": "string"
|
||
},
|
||
"user_id": {
|
||
"description": "资产归属用户ID",
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"user.ItemCardSimpleInfo": {
|
||
"type": "object",
|
||
"properties": {
|
||
"effect_type": {
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"user_card_id": {
|
||
"type": "integer"
|
||
}
|
||
}
|
||
},
|
||
"user.ItemCardWithTemplate": {
|
||
"type": "object",
|
||
"properties": {
|
||
"card_id": {
|
||
"description": "卡模板ID（system_item_cards.id）",
|
||
"type": "integer"
|
||
},
|
||
"card_type": {
|
||
"type": "integer"
|
||
},
|
||
"count": {
|
||
"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_activity_name": {
|
||
"type": "string"
|
||
},
|
||
"used_at": {
|
||
"description": "使用时间",
|
||
"type": "string"
|
||
},
|
||
"used_draw_log_id": {
|
||
"description": "使用关联抽奖日志ID（activity_draw_logs.id）",
|
||
"type": "integer"
|
||
},
|
||
"used_issue_id": {
|
||
"description": "使用时期ID",
|
||
"type": "integer"
|
||
},
|
||
"used_issue_number": {
|
||
"type": "string"
|
||
},
|
||
"used_reward_name": {
|
||
"type": "string"
|
||
},
|
||
"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"
|
||
},
|
||
"coupon_id": {
|
||
"description": "使用的优惠券ID",
|
||
"type": "integer"
|
||
},
|
||
"coupon_info": {
|
||
"$ref": "#/definitions/user.CouponSimpleInfo"
|
||
},
|
||
"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"
|
||
},
|
||
"item_card_id": {
|
||
"description": "使用的道具卡ID",
|
||
"type": "integer"
|
||
},
|
||
"item_card_info": {
|
||
"$ref": "#/definitions/user.ItemCardSimpleInfo"
|
||
},
|
||
"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)
|
||
}
|