70 lines
1 KiB
YAML
70 lines
1 KiB
YAML
Page:
|
|
in: query
|
|
name: page
|
|
schema:
|
|
type: integer
|
|
minimum: 1
|
|
default: 1
|
|
description: 页码
|
|
required: false
|
|
|
|
PerPage:
|
|
in: query
|
|
name: per_page
|
|
schema:
|
|
type: integer
|
|
minimum: 1
|
|
maximum: 100
|
|
default: 20
|
|
description: 每页记录数
|
|
required: false
|
|
|
|
Language:
|
|
in: query
|
|
name: lang
|
|
schema:
|
|
type: string
|
|
enum:
|
|
- en
|
|
- zh-Hans
|
|
- zh-Hant
|
|
description: 语言代码
|
|
required: false
|
|
|
|
Sort:
|
|
in: query
|
|
name: sort
|
|
schema:
|
|
type: string
|
|
pattern: '^[a-zA-Z_]+:(asc|desc)$'
|
|
examples:
|
|
- 'created_at:desc'
|
|
description: '排序字段和方向，格式为 field:(asc|desc)'
|
|
required: false
|
|
|
|
Status:
|
|
in: query
|
|
name: status
|
|
schema:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- published
|
|
description: 内容状态过滤
|
|
required: false
|
|
|
|
Id:
|
|
in: path
|
|
name: id
|
|
schema:
|
|
type: integer
|
|
required: true
|
|
description: 资源 ID
|
|
|
|
Slug:
|
|
in: path
|
|
name: slug
|
|
schema:
|
|
type: string
|
|
required: true
|
|
description: 资源 Slug
|