权限说明:普通用户只能操作自己上传的技能,管理员(用户名lh)可以操作所有技能
1. 获取技能列表
GET https://openskill.8cmblue.com/api/skills
Headers:
X-API-Key: YOUR_API_KEY
2. 上传技能
支持两种上传方式:
- 单文件技能:简单的Python脚本,使用
POST /api/skills
- 多文件技能:包含多个文件的完整项目,使用
POST /api/skills/upload
方式1:上传单文件技能
POST https://openskill.8cmblue.com/api/skills
Headers:
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Body:
{
name: 技能名称,
description: 技能描述,
content: 单个Python文件的完整代码,
version: 1.0.0,
category: 类别,
tags: 标签1,标签2
}
方式2:上传多文件技能(推荐)
适用场景:包含多个Python文件的完整项目,如 mhh-dianpuxiaoshouehuizong
POST https://openskill.8cmblue.com/api/skills/upload
Headers:
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Body:
{
name: 技能名称,
description: 技能描述,
version: 1.0.0,
category: 类别,
tags: 标签1,标签2,
files: [
{
path: main.py,
content: 主文件的完整代码
},
{
path: config.json,
content: 配置文件的完整内容
},
{
path: utils/helper.py,
content: 工具文件的完整代码
}
]
}
重要说明:
path:文件路径,相对于技能根目录(如 main.py, utils/helper.py)
content:文件的完整原始内容,不要修改或重新生成
- 保持项目结构完整,支持模块化代码和相互导入
3. 获取技能详情
GET https://openskill.8cmblue.com/api/skills/{skill_id}
Headers:
X-API-Key: YOUR_API_KEY
4. 更新技能(只能更新自己的技能,管理员可更新所有技能)
PUT https://openskill.8cmblue.com/api/skills/{skill_id}
Headers:
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Body:
{
"name": "新名称",
"description": "新描述",
"content": "新内容",
"version": "2.0.0"
}
5. 删除技能(只能删除自己的技能,管理员可删除所有技能)
DELETE https://openskill.8cmblue.com/api/skills/{skill_id}
Headers:
X-API-Key: YOUR_API_KEY