← 返回 miliaix.com
SOFTWARE RELEASES / API

软件发布管理

验证密钥后创建版本并上传安装包和图标。两份文件齐全后会自动发布，外部程序可用同一密钥检查更新和下载。

01

管理密钥

尚未验证

密钥由服务器环境变量 SOFTWARE_API_TOKEN 设置。浏览器只保存在当前标签页内存中，关闭或刷新页面后需要重新输入。

02

发布新版本

密钥验证后可用

03

外部接口调用

所有 /api 请求都需要密钥

对外 API 域名：https://soft.miliaix.com。请求头统一使用 Authorization: Bearer <你的密钥>。错误或缺失的密钥会收到 401，未设置服务器密钥时会收到 503。

POST
https://soft.miliaix.com/api/software/releases

创建版本草稿，JSON 字段：id、name、version、platform、packageFileName、iconFileName。

PUT
https://soft.miliaix.com/api/software/releases/{id}/{version}/package?platform=...

上传原始安装包二进制（不是 multipart）；使用创建版本接口返回的 URL。

PUT
https://soft.miliaix.com/api/software/releases/{id}/{version}/icon?platform=...

上传原始图标二进制；安装包和图标齐全后自动发布。

GET
https://soft.miliaix.com/api/software/{id}/update?current=1.0.0&platform=...

检查指定平台的更新，返回 latestVersion、updateAvailable 和 downloadUrl。

GET
https://soft.miliaix.com/api/software

获取每个软件的最新发布版本。

GET
https://soft.miliaix.com/api/software/{id}/download?version=1.2.0&platform=...

下载指定平台版本；单平台软件可省略 platform。

DELETE
https://soft.miliaix.com/api/software/releases/{id}/{version}?platform=...

删除尚未发布的草稿及其已上传文件。

验证密钥后读取已发布软件。

调用示例

TOKEN="你的密钥"

# 获取已发布软件列表
curl -H "Authorization: Bearer $TOKEN" \
  "https://soft.miliaix.com/api/software"

# 检查更新
curl -H "Authorization: Bearer $TOKEN" \
  "https://soft.miliaix.com/api/software/miliaix-editor/update?current=1.0.0&platform=macOS%20%2F%20Apple%20silicon"

# 创建版本，保存返回值里的 uploads.package / uploads.icon
curl -X POST "https://soft.miliaix.com/api/software/releases" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"miliaix-editor","name":"Miliaix Editor","version":"1.2.0","platform":"macOS / Apple silicon","packageFileName":"editor-1.2.0-arm64.dmg","iconFileName":"editor.svg"}'

# 上传原始文件内容
curl -X PUT "https://soft.miliaix.com/api/software/releases/miliaix-editor/1.2.0/package?platform=macOS%20%2F%20Apple%20silicon" \
  -H "Authorization: Bearer $TOKEN" --data-binary @editor-1.2.0-arm64.dmg
curl -X PUT "https://soft.miliaix.com/api/software/releases/miliaix-editor/1.2.0/icon?platform=macOS%20%2F%20Apple%20silicon" \
  -H "Authorization: Bearer $TOKEN" --data-binary @editor.svg

# 下载最新版本
curl -L -H "Authorization: Bearer $TOKEN" \
  "https://soft.miliaix.com/api/software/miliaix-editor/download?platform=macOS%20%2F%20Apple%20silicon" -o editor.dmg

建议仅通过 HTTPS 调用。密钥保存在服务端环境变量中；不要把真实密钥写入网页、客户端安装包或公开仓库。