分类管理
管理文章和项目分类的接口。
获取分类列表
获取所有分类列表。
接口信息
- 请求路径:
GET /api/admin/categories - 认证方式: 需要认证（管理员权限）
创建分类
创建新分类。
接口信息
- 请求路径:
POST /api/admin/categories - 认证方式: 需要认证（管理员权限）
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 分类名称 |
| type | string | 否 | 类型：article/project，默认 article |
| description | string | 否 | 分类描述 |
请求示例
bash
curl -X POST http://localhost:3000/api/admin/categories \
-H "Authorization: Bearer your-jwt-token" \
-H "Content-Type: application/json" \
-d '{
"name": "技术分享",
"type": "article",
"description": "分享技术文章"
}'更新分类
更新已有分类。
接口信息
- 请求路径:
PUT /api/admin/categories/:id - 认证方式: 需要认证（管理员权限）
请求示例
bash
curl -X PUT http://localhost:3000/api/admin/categories/1 \
-H "Authorization: Bearer your-jwt-token" \
-H "Content-Type: application/json" \
-d '{
"name": "更新后的分类名"
}'删除分类
删除指定分类。
接口信息
- 请求路径:
DELETE /api/admin/categories/:id - 认证方式: 需要认证（管理员权限）
请求示例
bash
curl -X DELETE http://localhost:3000/api/admin/categories/1 \
-H "Authorization: Bearer your-jwt-token"错误响应
| HTTP 状态码 | 说明 |
|---|---|
| 401 | 未登录或 Token 无效 |
| 403 | 权限不足（非管理员） |
| 404 | 分类不存在 |
| 400 | 参数错误 |
| 500 | 服务器错误 |