Skip to content

技能管理

管理技能展示的接口。

获取技能列表

获取所有技能。

接口信息

  • 请求路径: GET /api/admin/skills
  • 认证方式: 需要认证(管理员权限)

创建技能

创建新技能。

接口信息

  • 请求路径: POST /api/admin/skills
  • 认证方式: 需要认证(管理员权限)

请求参数

参数名类型必填说明
namestring技能名称
categorystring技能分类:frontend/backend/tool/other
levelnumber技能等级(1-100)
descriptionstring技能描述
iconstring图标 URL
ordernumber排序,默认 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服务器错误