2025-05-16 16:52:50 +08:00
|
|
|
|
{
|
|
|
|
|
|
"openapi": "3.0.0",
|
|
|
|
|
|
"info": {
|
|
|
|
|
|
"title": "My API",
|
|
|
|
|
|
"description": "API documentation using L5 Swagger",
|
|
|
|
|
|
"version": "1.0.0"
|
|
|
|
|
|
},
|
|
|
|
|
|
"servers": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"url": "https://KTV.test/",
|
|
|
|
|
|
"description": "API Server"
|
|
|
|
|
|
}
|
|
|
|
|
|
],
|
|
|
|
|
|
"paths": {
|
|
|
|
|
|
"/api/artists/search": {
|
|
|
|
|
|
"get": {
|
|
|
|
|
|
"tags": [
|
|
|
|
|
|
"Artist"
|
|
|
|
|
|
],
|
|
|
|
|
|
"summary": "搜尋藝人名稱",
|
|
|
|
|
|
"operationId": "f96ef111c1fadd6241138fd9840bf697",
|
|
|
|
|
|
"parameters": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"name": "search",
|
|
|
|
|
|
"in": "query",
|
|
|
|
|
|
"description": "關鍵字搜尋藝人名稱",
|
|
|
|
|
|
"required": false,
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"type": "string"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
{
|
|
|
|
|
|
"name": "selected",
|
|
|
|
|
|
"in": "query",
|
|
|
|
|
|
"description": "已選擇藝人 ID 陣列",
|
|
|
|
|
|
"required": false,
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"type": "array",
|
|
|
|
|
|
"items": {
|
|
|
|
|
|
"type": "integer"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
],
|
|
|
|
|
|
"responses": {
|
|
|
|
|
|
"200": {
|
|
|
|
|
|
"description": "搜尋結果"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"/api/profile": {
|
|
|
|
|
|
"get": {
|
|
|
|
|
|
"tags": [
|
|
|
|
|
|
"Auth"
|
|
|
|
|
|
],
|
|
|
|
|
|
"summary": "Get current user profile",
|
|
|
|
|
|
"operationId": "d32e56b6274eb68e980da6d91fbe9fd8",
|
|
|
|
|
|
"parameters": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"name": "Accept",
|
|
|
|
|
|
"in": "header",
|
|
|
|
|
|
"required": true,
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"default": "application/json"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
],
|
|
|
|
|
|
"responses": {
|
|
|
|
|
|
"200": {
|
|
|
|
|
|
"description": "User profile",
|
|
|
|
|
|
"content": {
|
|
|
|
|
|
"application/json": {
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"allOf": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"$ref": "#/components/schemas/ApiResponse"
|
|
|
|
|
|
},
|
|
|
|
|
|
{
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"data": {
|
|
|
|
|
|
"$ref": "#/components/schemas/User"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"401": {
|
|
|
|
|
|
"description": "Unauthorized",
|
|
|
|
|
|
"content": {
|
|
|
|
|
|
"application/json": {
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"allOf": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"$ref": "#/components/schemas/ApiResponse"
|
|
|
|
|
|
},
|
|
|
|
|
|
{
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"code": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "UNAUTHORIZED"
|
|
|
|
|
|
},
|
|
|
|
|
|
"message": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "Unauthorized"
|
|
|
|
|
|
},
|
|
|
|
|
|
"data": {
|
|
|
|
|
|
"type": "null"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"security": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"Authorization": []
|
|
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
2025-05-19 16:08:35 +08:00
|
|
|
|
},
|
|
|
|
|
|
"/api/room/receiveRegister": {
|
|
|
|
|
|
"post": {
|
|
|
|
|
|
"tags": [
|
|
|
|
|
|
"Room Control"
|
|
|
|
|
|
],
|
|
|
|
|
|
"summary": "包廂註冊控制指令",
|
|
|
|
|
|
"description": "依據傳入的 branch_id 與 room_name，知道過來的設備來之於那個IP設備。",
|
|
|
|
|
|
"operationId": "registerRoomCommand",
|
|
|
|
|
|
"parameters": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"name": "Accept",
|
|
|
|
|
|
"in": "header",
|
|
|
|
|
|
"required": true,
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"default": "application/json"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
],
|
|
|
|
|
|
"requestBody": {
|
|
|
|
|
|
"required": true,
|
|
|
|
|
|
"content": {
|
|
|
|
|
|
"application/json": {
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"$ref": "#/components/schemas/ReceiveRoomRegisterRequest"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"responses": {
|
|
|
|
|
|
"200": {
|
|
|
|
|
|
"description": "成功傳送指令並回傳 TCP 回應",
|
|
|
|
|
|
"content": {
|
|
|
|
|
|
"application/json": {
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"allOf": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"$ref": "#/components/schemas/ApiResponse"
|
|
|
|
|
|
},
|
|
|
|
|
|
{
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"data": {
|
|
|
|
|
|
"$ref": "#/components/schemas/Room"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"401": {
|
|
|
|
|
|
"description": "Unauthorized",
|
|
|
|
|
|
"content": {
|
|
|
|
|
|
"application/json": {
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"allOf": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"$ref": "#/components/schemas/ApiResponse"
|
|
|
|
|
|
},
|
|
|
|
|
|
{
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"code": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "UNAUTHORIZED"
|
|
|
|
|
|
},
|
|
|
|
|
|
"message": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "Unauthorized"
|
|
|
|
|
|
},
|
|
|
|
|
|
"data": {
|
|
|
|
|
|
"type": "null"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"security": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"Authorization": []
|
|
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"/api/room/sendSwitch": {
|
|
|
|
|
|
"post": {
|
|
|
|
|
|
"tags": [
|
|
|
|
|
|
"Room Control"
|
|
|
|
|
|
],
|
|
|
|
|
|
"summary": "送出包廂控制指令",
|
|
|
|
|
|
"description": "依據傳入的 room_id 與 command，透過 TCP 傳送對應指令給包廂電腦。",
|
|
|
|
|
|
"operationId": "sendRoomSwitchCommand",
|
|
|
|
|
|
"parameters": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"name": "Accept",
|
|
|
|
|
|
"in": "header",
|
|
|
|
|
|
"required": true,
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"default": "application/json"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
],
|
|
|
|
|
|
"requestBody": {
|
|
|
|
|
|
"required": true,
|
|
|
|
|
|
"content": {
|
|
|
|
|
|
"application/json": {
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"$ref": "#/components/schemas/SendRoomSwitchCommandRequest"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"responses": {
|
|
|
|
|
|
"200": {
|
|
|
|
|
|
"description": "成功傳送指令並回傳 TCP 回應",
|
|
|
|
|
|
"content": {
|
|
|
|
|
|
"application/json": {
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"allOf": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"$ref": "#/components/schemas/ApiResponse"
|
|
|
|
|
|
},
|
|
|
|
|
|
{
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"data": {
|
|
|
|
|
|
"$ref": "#/components/schemas/Room"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"401": {
|
|
|
|
|
|
"description": "Unauthorized",
|
|
|
|
|
|
"content": {
|
|
|
|
|
|
"application/json": {
|
|
|
|
|
|
"schema": {
|
|
|
|
|
|
"allOf": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"$ref": "#/components/schemas/ApiResponse"
|
|
|
|
|
|
},
|
|
|
|
|
|
{
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"code": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "UNAUTHORIZED"
|
|
|
|
|
|
},
|
|
|
|
|
|
"message": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "Unauthorized"
|
|
|
|
|
|
},
|
|
|
|
|
|
"data": {
|
|
|
|
|
|
"type": "null"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"security": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"Authorization": []
|
|
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
2025-05-16 16:52:50 +08:00
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"components": {
|
|
|
|
|
|
"schemas": {
|
2025-05-19 16:08:35 +08:00
|
|
|
|
"RoomStatus": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"enum": [
|
|
|
|
|
|
"active",
|
|
|
|
|
|
"closed",
|
|
|
|
|
|
"fire",
|
|
|
|
|
|
"error",
|
|
|
|
|
|
"maintenance"
|
|
|
|
|
|
],
|
|
|
|
|
|
"example": "error"
|
|
|
|
|
|
},
|
2025-05-16 16:52:50 +08:00
|
|
|
|
"UserGender": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"enum": [
|
|
|
|
|
|
"male",
|
|
|
|
|
|
"female",
|
|
|
|
|
|
"other",
|
|
|
|
|
|
"unset"
|
|
|
|
|
|
],
|
|
|
|
|
|
"example": "male"
|
|
|
|
|
|
},
|
|
|
|
|
|
"UserStatus": {
|
|
|
|
|
|
"description": "User status: 0=Active, 1=Suspended, 2=Deleting",
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"enum": [
|
|
|
|
|
|
"Active",
|
|
|
|
|
|
"Suspended",
|
|
|
|
|
|
"Deleting"
|
|
|
|
|
|
],
|
|
|
|
|
|
"example": "0"
|
|
|
|
|
|
},
|
2025-05-19 16:08:35 +08:00
|
|
|
|
"ReceiveRoomRegisterRequest": {
|
|
|
|
|
|
"required": [
|
|
|
|
|
|
"branch_id",
|
|
|
|
|
|
"room_id",
|
|
|
|
|
|
"ip"
|
|
|
|
|
|
],
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"branch_id": {
|
|
|
|
|
|
"type": "integer",
|
|
|
|
|
|
"example": "5"
|
|
|
|
|
|
},
|
|
|
|
|
|
"room_name": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "pc102"
|
|
|
|
|
|
},
|
|
|
|
|
|
"ip": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "192.168.x.x"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
},
|
|
|
|
|
|
"SendRoomSwitchCommandRequest": {
|
|
|
|
|
|
"required": [
|
|
|
|
|
|
"room_id",
|
|
|
|
|
|
"command"
|
|
|
|
|
|
],
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"branch_id": {
|
|
|
|
|
|
"type": "integer",
|
|
|
|
|
|
"example": "5"
|
|
|
|
|
|
},
|
|
|
|
|
|
"room_name": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "pc102"
|
|
|
|
|
|
},
|
|
|
|
|
|
"command": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"enum": [
|
|
|
|
|
|
"active",
|
|
|
|
|
|
"closed",
|
|
|
|
|
|
"maintenance"
|
|
|
|
|
|
],
|
|
|
|
|
|
"example": "active"
|
|
|
|
|
|
},
|
|
|
|
|
|
"started_at": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "2025-05-19 09:31:00",
|
|
|
|
|
|
"nullable": true
|
|
|
|
|
|
},
|
|
|
|
|
|
"ended_at": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "2025-05-19 09:31:00",
|
|
|
|
|
|
"nullable": true
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
},
|
2025-05-16 16:52:50 +08:00
|
|
|
|
"ApiResponse": {
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"code": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "OK"
|
|
|
|
|
|
},
|
|
|
|
|
|
"message": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "Success"
|
|
|
|
|
|
},
|
|
|
|
|
|
"data": {
|
|
|
|
|
|
"type": "object",
|
|
|
|
|
|
"nullable": true
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
},
|
2025-05-19 16:08:35 +08:00
|
|
|
|
"Room": {
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"id": {
|
|
|
|
|
|
"type": "integer",
|
|
|
|
|
|
"example": 16
|
|
|
|
|
|
},
|
|
|
|
|
|
"name": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "pc102"
|
|
|
|
|
|
},
|
|
|
|
|
|
"internal_ip": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "192.168.11.7"
|
|
|
|
|
|
},
|
|
|
|
|
|
"port": {
|
|
|
|
|
|
"type": "integer",
|
|
|
|
|
|
"example": "9000"
|
|
|
|
|
|
},
|
|
|
|
|
|
"status": {
|
|
|
|
|
|
"$ref": "#/components/schemas/RoomStatus"
|
|
|
|
|
|
},
|
|
|
|
|
|
"started_at": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"format": "date-time",
|
|
|
|
|
|
"example": "2025-05-11T16:00:00.000000Z"
|
|
|
|
|
|
},
|
|
|
|
|
|
"ended_at": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"format": "date-time",
|
|
|
|
|
|
"example": null
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
},
|
2025-05-16 16:52:50 +08:00
|
|
|
|
"User": {
|
|
|
|
|
|
"properties": {
|
|
|
|
|
|
"id": {
|
|
|
|
|
|
"type": "integer",
|
|
|
|
|
|
"example": 1
|
|
|
|
|
|
},
|
|
|
|
|
|
"name": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "John Doe"
|
|
|
|
|
|
},
|
|
|
|
|
|
"email": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "john@example.com"
|
|
|
|
|
|
},
|
|
|
|
|
|
"phone": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"example": "0900000000"
|
|
|
|
|
|
},
|
|
|
|
|
|
"birthday": {
|
|
|
|
|
|
"type": "string",
|
|
|
|
|
|
"format": "date-time",
|
|
|
|
|
|
"example": "2025-05-11T16:00:00.000000Z"
|
|
|
|
|
|
},
|
|
|
|
|
|
"gender": {
|
|
|
|
|
|
"$ref": "#/components/schemas/UserGender"
|
|
|
|
|
|
},
|
|
|
|
|
|
"status": {
|
|
|
|
|
|
"$ref": "#/components/schemas/UserStatus"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"type": "object"
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"securitySchemes": {
|
|
|
|
|
|
"Authorization": {
|
|
|
|
|
|
"type": "http",
|
|
|
|
|
|
"bearerFormat": "JWT",
|
|
|
|
|
|
"scheme": "bearer"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
"tags": [
|
|
|
|
|
|
{
|
|
|
|
|
|
"name": "Artist",
|
|
|
|
|
|
"description": "藝人資料搜尋"
|
|
|
|
|
|
},
|
|
|
|
|
|
{
|
|
|
|
|
|
"name": "Auth",
|
2025-05-19 16:08:35 +08:00
|
|
|
|
"description": "包廂控制"
|
|
|
|
|
|
},
|
|
|
|
|
|
{
|
|
|
|
|
|
"name": "Room Control",
|
|
|
|
|
|
"description": "Room Control"
|
2025-05-16 16:52:50 +08:00
|
|
|
|
}
|
|
|
|
|
|
]
|
|
|
|
|
|
}
|
