nebula/docs/RELEASE_API.md

Release API 使用示例

服务器地址: http://localhost:9050

1. 创建应用（前置步骤）

curl -X POST http://localhost:9050/api/apps \
  -H "Content-Type: application/json" \
  -d '{
    "id": "my-app",
    "name": "我的应用",
    "description": "这是一个测试应用"
  }'

2. 创建版本发布

curl -X POST http://localhost:9050/api/releases \
  -H "Content-Type: application/json" \
  -d '{
    "appID": "my-app",
    "version": "1.0.0",
    "notes": "第一个正式版本\n- 新增功能A\n- 修复bug B",
    "channel": "stable",
    "pubDate": "2026-03-10T10:00:00Z"
  }'

3. 获取所有版本列表

curl http://localhost:9050/api/releases

4. 获取指定应用的版本列表

curl http://localhost:9050/api/apps/my-app/releases

5. 按渠道筛选版本

# 获取 stable 渠道的版本
curl "http://localhost:9050/api/apps/my-app/releases?channel=stable"

6. 获取最新版本

curl http://localhost:9050/api/apps/my-app/releases/latest

# 获取指定渠道的最新版本
curl "http://localhost:9050/api/apps/my-app/releases/latest?channel=stable"

7. 获取单个版本详情

curl http://localhost:9050/api/releases/1

8. 更新版本信息

curl -X PUT http://localhost:9050/api/releases/1 \
  -H "Content-Type: application/json" \
  -d '{
    "version": "1.0.1",
    "notes": "更新内容",
    "channel": "stable",
    "pubDate": "2026-03-10T12:00:00Z"
  }'

9. 删除版本

curl -X DELETE http://localhost:9050/api/releases/1

完整测试流程

# 1. 创建应用
Invoke-RestMethod -Method POST -Uri "http://localhost:9050/api/apps" `
  -ContentType "application/json" `
  -Body '{"id":"test-app","name":"测试应用","description":"测试用"}'

# 2. 创建第一个版本
Invoke-RestMethod -Method POST -Uri "http://localhost:9050/api/releases" `
  -ContentType "application/json" `
  -Body '{"appID":"test-app","version":"1.0.0","notes":"初始版本","channel":"stable","pubDate":"2026-03-10T10:00:00Z"}'

# 3. 创建第二个版本
Invoke-RestMethod -Method POST -Uri "http://localhost:9050/api/releases" `
  -ContentType "application/json" `
  -Body '{"appID":"test-app","version":"1.1.0","notes":"功能更新","channel":"stable","pubDate":"2026-03-10T12:00:00Z"}'

# 4. 查看该应用的所有版本
Invoke-RestMethod -Uri "http://localhost:9050/api/apps/test-app/releases"

# 5. 获取最新版本
Invoke-RestMethod -Uri "http://localhost:9050/api/apps/test-app/releases/latest"

API 路由列表

方法	路径	说明
GET	/api/releases	获取所有版本列表
GET	/api/releases/:id	获取单个版本详情
POST	/api/releases	创建新版本
PUT	/api/releases/:id	更新版本信息
DELETE	/api/releases/:id	删除版本
GET	/api/apps/:id/releases	获取指定应用的版本列表
GET	/api/apps/:id/releases/latest	获取应用的最新版本

响应格式

成功响应:

{
  "code": 0,
  "msg": "ok",
  "data": { ... }
}

错误响应:

{
  "code": 500,
  "msg": "错误信息"
}