文章管理
管理文章的增删改查接口。
获取文章列表
获取后台管理的文章列表（包含草稿）。
接口信息
- 请求路径:
GET /api/admin/articles - 认证方式: 需要认证（管理员权限）
查询参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | number | 否 | 页码，默认 1 |
| limit | number | 否 | 每页数量，默认 10 |
| status | string | 否 | 状态筛选：published/draft |
| keyword | string | 否 | 关键词搜索 |
创建文章
创建新文章。
接口信息
- 请求路径:
POST /api/admin/articles - 认证方式: 需要认证（管理员权限）
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 是 | 文章标题 |
| content | string | 是 | 文章内容（Markdown） |
| categoryId | number | 是 | 分类 ID |
| excerpt | string | 否 | 文章摘要 |
| coverImage | string | 否 | 封面图片 URL |
| status | string | 否 | 状态：published/draft，默认 draft |
请求示例
bash
curl -X POST http://localhost:3000/api/admin/articles \
-H "Authorization: Bearer your-jwt-token" \
-H "Content-Type: application/json" \
-d '{
"title": "我的新文章",
"content": "# 文章内容\n\n...",
"categoryId": 1,
"status": "published"
}'更新文章
更新已有文章。
接口信息
- 请求路径:
PUT /api/admin/articles/:id - 认证方式: 需要认证（管理员权限）
请求参数
同创建文章，所有字段均为可选。
请求示例
bash
curl -X PUT http://localhost:3000/api/admin/articles/1 \
-H "Authorization: Bearer your-jwt-token" \
-H "Content-Type: application/json" \
-d '{
"title": "更新后的标题",
"status": "published"
}'删除文章
删除指定文章。
接口信息
- 请求路径:
DELETE /api/admin/articles/:id - 认证方式: 需要认证（管理员权限）
请求示例
bash
curl -X DELETE http://localhost:3000/api/admin/articles/1 \
-H "Authorization: Bearer your-jwt-token"错误响应
| HTTP 状态码 | 说明 |
|---|---|
| 401 | 未登录或 Token 无效 |
| 403 | 权限不足（非管理员） |
| 404 | 文章不存在 |
| 400 | 参数错误 |
| 500 | 服务器错误 |