docs: update admin categories API with pagination parameters

- Add page/limit query parameters documentation
- Update response format to include pagination metadata
- Specify parameter constraints (page ≥ 1, limit 1-50)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Wang Zhuoxuan 2026-04-11 12:57:24 +08:00
parent 6e65993f89
commit 4c0419649b

View File

@ -931,10 +931,14 @@
#### GET /admin/categories #### GET /admin/categories
获取所有分类。 获取分类列表
**认证**: Admin Token **认证**: Admin Token
**查询参数**:
- `page`: 页码 (默认: 1, 必须 ≥ 1)
- `limit`: 每页数量 (默认: 20, 范围: 1-50)
**响应**: **响应**:
```json ```json
{ {
@ -946,9 +950,15 @@
"slug": "history", "slug": "history",
"parentId": null, "parentId": null,
"sortOrder": 1, "sortOrder": 1,
"questionCount": 120,
"status": "active" "status": "active"
} }
], ],
"pagination": {
"total": 45,
"page": 1,
"limit": 20
},
"error": null "error": null
} }
``` ```