[feature] migrate to monorepo
This commit is contained in:
commit
05ddc1f783
267 changed files with 75165 additions and 0 deletions
111
api/schemas/paths/media.yaml
Normal file
111
api/schemas/paths/media.yaml
Normal file
|
@ -0,0 +1,111 @@
|
|||
media:
|
||||
get:
|
||||
tags:
|
||||
- media
|
||||
summary: 获取媒体文件列表
|
||||
operationId: listMedia
|
||||
parameters:
|
||||
- $ref: '../components/parameters.yaml#/Page'
|
||||
- $ref: '../components/parameters.yaml#/PerPage'
|
||||
- $ref: '../components/parameters.yaml#/Sort'
|
||||
- name: mime_type
|
||||
in: query
|
||||
schema:
|
||||
type: string
|
||||
description: 按 MIME 类型筛选
|
||||
responses:
|
||||
'200':
|
||||
description: 成功获取媒体文件列表
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
allOf:
|
||||
- $ref: '../components/schemas.yaml#/Response'
|
||||
- type: object
|
||||
properties:
|
||||
data:
|
||||
type: array
|
||||
items:
|
||||
$ref: '../components/schemas.yaml#/Media'
|
||||
'401':
|
||||
$ref: '../components/responses.yaml#/Unauthorized'
|
||||
post:
|
||||
tags:
|
||||
- media
|
||||
summary: 上传媒体文件
|
||||
description: |
|
||||
上传媒体文件。对于图片文件:
|
||||
- 支持的输入格式:JPEG、PNG、GIF
|
||||
- 所有图片将自动转换为 WebP 格式
|
||||
- 使用无损压缩以保持图片质量
|
||||
- 保持原始图片尺寸
|
||||
operationId: uploadMedia
|
||||
requestBody:
|
||||
required: true
|
||||
content:
|
||||
multipart/form-data:
|
||||
schema:
|
||||
type: object
|
||||
required:
|
||||
- file
|
||||
properties:
|
||||
file:
|
||||
type: string
|
||||
format: binary
|
||||
description: |
|
||||
要上传的文件。
|
||||
对于图片文件,将自动转换为 WebP 格式。
|
||||
支持的图片格式:image/jpeg, image/png, image/gif
|
||||
responses:
|
||||
'201':
|
||||
description: 媒体文件上传成功
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
data:
|
||||
$ref: '../components/schemas.yaml#/Media'
|
||||
'401':
|
||||
$ref: '../components/responses.yaml#/Unauthorized'
|
||||
'403':
|
||||
$ref: '../components/responses.yaml#/Forbidden'
|
||||
'422':
|
||||
$ref: '../components/responses.yaml#/ValidationError'
|
||||
|
||||
media_id:
|
||||
parameters:
|
||||
- $ref: '../components/parameters.yaml#/Id'
|
||||
get:
|
||||
tags:
|
||||
- media
|
||||
summary: 获取媒体文件详情
|
||||
operationId: getMedia
|
||||
responses:
|
||||
'200':
|
||||
description: 成功获取媒体文件详情
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
data:
|
||||
$ref: '../components/schemas.yaml#/Media'
|
||||
'404':
|
||||
$ref: '../components/responses.yaml#/NotFound'
|
||||
delete:
|
||||
tags:
|
||||
- media
|
||||
summary: 删除媒体文件
|
||||
operationId: deleteMedia
|
||||
parameters:
|
||||
- $ref: '../components/parameters.yaml#/Id'
|
||||
responses:
|
||||
'204':
|
||||
description: 媒体文件删除成功
|
||||
'401':
|
||||
$ref: '../components/responses.yaml#/Unauthorized'
|
||||
'403':
|
||||
$ref: '../components/responses.yaml#/Forbidden'
|
||||
'404':
|
||||
$ref: '../components/responses.yaml#/NotFound'
|
Loading…
Add table
Add a link
Reference in a new issue