技能管理
管理技能展示的接口。
获取技能列表
获取所有技能。
接口信息
- 请求路径:
GET /api/admin/skills - 认证方式: 需要认证(管理员权限)
创建技能
创建新技能。
接口信息
- 请求路径:
POST /api/admin/skills - 认证方式: 需要认证(管理员权限)
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 技能名称 |
| category | string | 是 | 技能分类:frontend/backend/tool/other |
| level | number | 是 | 技能等级(1-100) |
| description | string | 否 | 技能描述 |
| icon | string | 否 | 图标 URL |
| order | number | 否 | 排序,默认 0 |
请求示例
bash
curl -X POST http://localhost:3000/api/admin/skills \
-H "Authorization: Bearer your-jwt-token" \
-H "Content-Type: application/json" \
-d '{
"name": "Vue.js",
"category": "frontend",
"level": 90,
"description": "熟练使用 Vue.js 开发"
}'更新技能
更新已有技能。
接口信息
- 请求路径:
PUT /api/admin/skills/:id - 认证方式: 需要认证(管理员权限)
删除技能
删除指定技能。
接口信息
- 请求路径:
DELETE /api/admin/skills/:id - 认证方式: 需要认证(管理员权限)
错误响应
| HTTP 状态码 | 说明 |
|---|---|
| 401 | 未登录或 Token 无效 |
| 403 | 权限不足(非管理员) |
| 404 | 技能不存在 |
| 400 | 参数错误 |
| 500 | 服务器错误 |