分享码日志新增 model 字段,记录操作的设备的型号 X8/X9

This commit is contained in:
eafonyang
2026-06-17 13:52:11 +08:00
parent 1e7dc01b22
commit 7687e6a0d9
12 changed files with 214 additions and 577 deletions
+56 -46
View File
@@ -464,50 +464,6 @@ const docTemplate = `{
}
}
},
"/audio/shareQuery": {
"get": {
"description": "根据分享码预览 EQ 数据,不写入导入流水",
"produces": [
"application/json"
],
"tags": [
"ShareCode"
],
"summary": "查询 EQ 分享码",
"parameters": [
{
"type": "string",
"description": "5 位分享码",
"name": "shareCode",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "成功返回 eq_data、expire_at",
"schema": {
"type": "object",
"additionalProperties": true
}
},
"400": {
"description": "参数校验失败",
"schema": {
"type": "object",
"additionalProperties": true
}
},
"500": {
"description": "系统错误",
"schema": {
"type": "object",
"additionalProperties": true
}
}
}
}
},
"/audio/shareAccept": {
"get": {
"description": "根据分享码获取他人分享的 EQ 数据",
@@ -526,6 +482,13 @@ const docTemplate = `{
"in": "query",
"required": true
},
{
"type": "string",
"description": "操作设备型号,取值 Luxsin-X9 或 Luxsin-X8",
"name": "model",
"in": "query",
"required": true
},
{
"type": "string",
"description": "5 位分享码",
@@ -561,7 +524,7 @@ const docTemplate = `{
},
"/audio/shareCreate": {
"post": {
"description": "将用户的 EQ 数据生成一个 5 位分享码,有效期 30 分钟",
"description": "将用户的 EQ 数据生成一个 5 位分享码,有效期由 SHARE_CODE_TTL_MIN 配置决定(支持 30、30m、24h、30d 等格式)",
"consumes": [
"application/json"
],
@@ -574,7 +537,7 @@ const docTemplate = `{
"summary": "创建 EQ 分享码",
"parameters": [
{
"description": "分享请求",
"description": "分享请求model 取值 Luxsin-X9 或 Luxsin-X8",
"name": "body",
"in": "body",
"required": true,
@@ -586,6 +549,9 @@ const docTemplate = `{
},
"mac": {
"type": "string"
},
"model": {
"type": "string"
}
}
}
@@ -659,6 +625,50 @@ const docTemplate = `{
}
}
}
},
"/audio/shareQuery": {
"get": {
"description": "根据分享码预览 EQ 数据,不写入导入流水",
"produces": [
"application/json"
],
"tags": [
"ShareCode"
],
"summary": "查询 EQ 分享码",
"parameters": [
{
"type": "string",
"description": "5 位分享码",
"name": "shareCode",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "成功返回 eq_data、expire_at",
"schema": {
"type": "object",
"additionalProperties": true
}
},
"400": {
"description": "参数校验失败",
"schema": {
"type": "object",
"additionalProperties": true
}
},
"500": {
"description": "系统错误",
"schema": {
"type": "object",
"additionalProperties": true
}
}
}
}
}
}
}`
+56 -46
View File
@@ -457,50 +457,6 @@
}
}
},
"/audio/shareQuery": {
"get": {
"description": "根据分享码预览 EQ 数据,不写入导入流水",
"produces": [
"application/json"
],
"tags": [
"ShareCode"
],
"summary": "查询 EQ 分享码",
"parameters": [
{
"type": "string",
"description": "5 位分享码",
"name": "shareCode",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "成功返回 eq_data、expire_at",
"schema": {
"type": "object",
"additionalProperties": true
}
},
"400": {
"description": "参数校验失败",
"schema": {
"type": "object",
"additionalProperties": true
}
},
"500": {
"description": "系统错误",
"schema": {
"type": "object",
"additionalProperties": true
}
}
}
}
},
"/audio/shareAccept": {
"get": {
"description": "根据分享码获取他人分享的 EQ 数据",
@@ -519,6 +475,13 @@
"in": "query",
"required": true
},
{
"type": "string",
"description": "操作设备型号,取值 Luxsin-X9 或 Luxsin-X8",
"name": "model",
"in": "query",
"required": true
},
{
"type": "string",
"description": "5 位分享码",
@@ -554,7 +517,7 @@
},
"/audio/shareCreate": {
"post": {
"description": "将用户的 EQ 数据生成一个 5 位分享码,有效期 30 分钟",
"description": "将用户的 EQ 数据生成一个 5 位分享码,有效期由 SHARE_CODE_TTL_MIN 配置决定(支持 30、30m、24h、30d 等格式)",
"consumes": [
"application/json"
],
@@ -567,7 +530,7 @@
"summary": "创建 EQ 分享码",
"parameters": [
{
"description": "分享请求",
"description": "分享请求model 取值 Luxsin-X9 或 Luxsin-X8",
"name": "body",
"in": "body",
"required": true,
@@ -579,6 +542,9 @@
},
"mac": {
"type": "string"
},
"model": {
"type": "string"
}
}
}
@@ -652,6 +618,50 @@
}
}
}
},
"/audio/shareQuery": {
"get": {
"description": "根据分享码预览 EQ 数据,不写入导入流水",
"produces": [
"application/json"
],
"tags": [
"ShareCode"
],
"summary": "查询 EQ 分享码",
"parameters": [
{
"type": "string",
"description": "5 位分享码",
"name": "shareCode",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "成功返回 eq_data、expire_at",
"schema": {
"type": "object",
"additionalProperties": true
}
},
"400": {
"description": "参数校验失败",
"schema": {
"type": "object",
"additionalProperties": true
}
},
"500": {
"description": "系统错误",
"schema": {
"type": "object",
"additionalProperties": true
}
}
}
}
}
}
}
+40 -32
View File
@@ -303,36 +303,6 @@ paths:
summary: 上报设备信息
tags:
- Device
/audio/shareQuery:
get:
description: 根据分享码预览 EQ 数据,不写入导入流水
parameters:
- description: 5 位分享码
in: query
name: shareCode
required: true
type: string
produces:
- application/json
responses:
"200":
description: 成功返回 eq_data、expire_at
schema:
additionalProperties: true
type: object
"400":
description: 参数校验失败
schema:
additionalProperties: true
type: object
"500":
description: 系统错误
schema:
additionalProperties: true
type: object
summary: 查询 EQ 分享码
tags:
- ShareCode
/audio/shareAccept:
get:
description: 根据分享码获取他人分享的 EQ 数据
@@ -342,6 +312,11 @@ paths:
name: mac
required: true
type: string
- description: 操作设备型号,取值 Luxsin-X9 或 Luxsin-X8
in: query
name: model
required: true
type: string
- description: 5 位分享码
in: query
name: shareCode
@@ -372,9 +347,10 @@ paths:
post:
consumes:
- application/json
description: 将用户的 EQ 数据生成一个 5 位分享码,有效期 30 分钟
description: 将用户的 EQ 数据生成一个 5 位分享码,有效期由 SHARE_CODE_TTL_MIN 配置决定(支持 30、30m、24h、30d
等格式)
parameters:
- description: 分享请求
- description: 分享请求model 取值 Luxsin-X9 或 Luxsin-X8
in: body
name: body
required: true
@@ -384,6 +360,8 @@ paths:
type: object
mac:
type: string
model:
type: string
type: object
produces:
- application/json
@@ -436,4 +414,34 @@ paths:
summary: 查询未过期分享码
tags:
- ShareCode
/audio/shareQuery:
get:
description: 根据分享码预览 EQ 数据,不写入导入流水
parameters:
- description: 5 位分享码
in: query
name: shareCode
required: true
type: string
produces:
- application/json
responses:
"200":
description: 成功返回 eq_data、expire_at
schema:
additionalProperties: true
type: object
"400":
description: 参数校验失败
schema:
additionalProperties: true
type: object
"500":
description: 系统错误
schema:
additionalProperties: true
type: object
summary: 查询 EQ 分享码
tags:
- ShareCode
swagger: "2.0"