fix(openapi): 补全 Response 必填 description,修复 Swagger Fetch error

音乐/小说等 31 处 responses.200 缺 description,OpenAPI 3.0 校验失败导致 /docs 无法渲染。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
DESKTOP-L8OUL9F\gfl0034 2026-09-24 10:58:47 +08:00
parent 13b42cef7b
commit 59c79c7d32

View File

@ -1983,6 +1983,7 @@ paths:
- bearerAuth: [] - bearerAuth: []
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2002,6 +2003,7 @@ paths:
$ref: "#/components/schemas/MusicSettings" $ref: "#/components/schemas/MusicSettings"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2029,6 +2031,7 @@ paths:
$ref: "#/components/schemas/MusicUpsertRequest" $ref: "#/components/schemas/MusicUpsertRequest"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2046,6 +2049,7 @@ paths:
schema: { type: integer, format: int64 } schema: { type: integer, format: int64 }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2060,6 +2064,7 @@ paths:
- bearerAuth: [] - bearerAuth: []
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2081,6 +2086,7 @@ paths:
$ref: "#/components/schemas/MusicCategoryUpsertRequest" $ref: "#/components/schemas/MusicCategoryUpsertRequest"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2105,6 +2111,7 @@ paths:
$ref: "#/components/schemas/MusicCategoryUpsertRequest" $ref: "#/components/schemas/MusicCategoryUpsertRequest"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2122,6 +2129,7 @@ paths:
schema: { type: integer, format: int64 } schema: { type: integer, format: int64 }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2152,6 +2160,7 @@ paths:
items: { type: integer, format: int64 } items: { type: integer, format: int64 }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2182,6 +2191,7 @@ paths:
format: binary format: binary
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2212,6 +2222,7 @@ paths:
format: binary format: binary
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2242,6 +2253,7 @@ paths:
format: binary format: binary
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2280,6 +2292,7 @@ paths:
description: true 时返回一级含 children 树 description: true 时返回一级含 children 树
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2305,6 +2318,7 @@ paths:
- { name: size, in: query, schema: { type: integer, default: 24 } } - { name: size, in: query, schema: { type: integer, default: 24 } }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2325,6 +2339,7 @@ paths:
schema: { type: string } schema: { type: string }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2345,6 +2360,7 @@ paths:
schema: { type: string } schema: { type: string }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2365,6 +2381,7 @@ paths:
- { name: chapterSlug, in: path, required: true, schema: { type: string } } - { name: chapterSlug, in: path, required: true, schema: { type: string } }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2403,6 +2420,7 @@ paths:
- url: https://admin.fullstorynovel.com - url: https://admin.fullstorynovel.com
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2421,6 +2439,7 @@ paths:
- url: https://admin.fullstorynovel.com - url: https://admin.fullstorynovel.com
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2441,6 +2460,7 @@ paths:
$ref: "#/components/schemas/FsnNovelUpsert" $ref: "#/components/schemas/FsnNovelUpsert"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2459,6 +2479,7 @@ paths:
schema: { type: integer, format: int64 } schema: { type: integer, format: int64 }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2482,6 +2503,7 @@ paths:
$ref: "#/components/schemas/FsnNovelUpsert" $ref: "#/components/schemas/FsnNovelUpsert"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2499,6 +2521,7 @@ paths:
schema: { type: integer, format: int64 } schema: { type: integer, format: int64 }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2544,6 +2567,7 @@ paths:
schema: { type: integer, format: int64 } schema: { type: integer, format: int64 }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2569,6 +2593,7 @@ paths:
$ref: "#/components/schemas/FsnChapterUpsert" $ref: "#/components/schemas/FsnChapterUpsert"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2607,6 +2632,7 @@ paths:
$ref: "#/components/schemas/FsnChapterUpsert" $ref: "#/components/schemas/FsnChapterUpsert"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2624,6 +2650,7 @@ paths:
schema: { type: integer, format: int64 } schema: { type: integer, format: int64 }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2639,6 +2666,7 @@ paths:
- url: https://admin.fullstorynovel.com - url: https://admin.fullstorynovel.com
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2659,6 +2687,7 @@ paths:
$ref: "#/components/schemas/FsnGenreUpsert" $ref: "#/components/schemas/FsnGenreUpsert"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2683,6 +2712,7 @@ paths:
$ref: "#/components/schemas/FsnGenreUpsert" $ref: "#/components/schemas/FsnGenreUpsert"
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema:
@ -2700,6 +2730,7 @@ paths:
schema: { type: integer, format: int64 } schema: { type: integer, format: int64 }
responses: responses:
"200": "200":
description: OK
content: content:
application/json: application/json:
schema: schema: