传音 API v1

传音 · 应用分发平台 · 基址 https://appstore.yuseed.com · 全部接口返回 JSON（UTF-8）

返回体里的 download_url / icon_url 均为该应用的公网绝对地址（https://appstore.yuseed.com/...），可直接下发、写二维码或贴给第三方客户端。

认证

读接口（GET）匿名可访问；写接口（POST / DELETE）需要管理员身份，两种方式任选：

① HTTP Basic（推荐给脚本/curl）
   curl -u admin:你的密码 ...

② 网页登录后的 Session Cookie（浏览器里调 API 时自动带上）

认证失败返回 401 + {"error":"unauthorized"}；用户名或密码错误同样 401。修改密码入口：/password（网页）或 POST /api/v1/password（API）。

接口一览

GET/api/v1/apps🌐 匿名

应用列表。返回 {count, apps:[{slug,name,platform,description,icon_url,created_at,latest_version,releases_count,total_downloads}]}

GET/api/v1/apps/<slug>🌐 匿名

应用详情，含 releases[]（每个版本带 version / size / size_human / sha256 / notes / downloads / download_url）。404 = 应用不存在。

POST/api/v1/apps🔒 Basic

新建应用。两种提交方式：

方式	字段
JSON	`name`、`slug`、`platform`、`description`
form-data	同上，另可带 `icon`（png 文件）

* 必填。slug：小写字母/数字/连字符，2~41 位。platform ∈ android/windows/linux/macos/web/other。成功 201；slug 冲突 409。

POST/api/v1/apps/<slug>/releases🔒 Basic

发布新版本。multipart/form-data：version*（版本号，同一应用内唯一）、package*（安装包文件，≤2GB）、notes（更新说明）。服务端自动计算 sha256 与 size。成功 201 返回版本记录；版本号重复 409；NAS 不可写 503。

DELETE/api/v1/apps/<slug>/releases/<version>🔒 Basic

删除指定版本（连 NAS 上的安装包文件一起删）。

DELETE/api/v1/apps/<slug>🔒 Basic

删除整个应用（含全部版本文件与图标）。⚠️ 不可恢复。

POST/api/v1/password🔒 Basic

修改密码。JSON：{"current_password":"...","new_password":"..."}。新密码 ≥8 位且不能与当前相同。成功 {"changed":true}。

GET/healthz🌐 匿名

健康检查：{"db":true,"nas":true}，NAS 不可写时 503。

curl 示例

# 列出应用
curl https://appstore.yuseed.com/api/v1/apps

# 新建应用（JSON）
curl -u admin:密码 -H "Content-Type: application/json" \
  -d '{"name":"计算器","slug":"calc","platform":"android","description":"自研"}' \
  https://appstore.yuseed.com/api/v1/apps

# 发布版本（form-data 上传文件）
curl -u admin:密码 \
  -F version=1.0.0 -F notes="首个版本" -F package=@calc-1.0.0.apk \
  https://appstore.yuseed.com/api/v1/apps/calc/releases

# 修改密码
curl -u admin:旧密码 -H "Content-Type: application/json" \
  -d '{"current_password":"旧密码","new_password":"新密码至少8位"}' \
  https://appstore.yuseed.com/api/v1/password

# 删除版本 / 删除应用
curl -u admin:密码 -X DELETE https://appstore.yuseed.com/api/v1/apps/calc/releases/1.0.0
curl -u admin:密码 -X DELETE https://appstore.yuseed.com/api/v1/apps/calc

网页版对应功能

应用列表 · 修改密码 · 管理操作（新建/发布/删除）请在网页登录后使用。