111 lines
3.1 KiB
YAML
111 lines
3.1 KiB
YAML
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'
|