公开接口用于读取软件、版本和申请下载链接;软件维护者使用个人 Token 更新自己负责的软件、图片和安装包。
Base URL: https://<site-domain>/api/v1 Authorization: Bearer daisy_xxxxxxxxxxxxxxxxx
维护者先使用原有后台账号登录,创建个人 Token。Token 只在创建时显示一次,后台只保存哈希。
curl -c cookies.txt -X POST \
https://<site-domain>/api/v1/admin/login \
-H 'Content-Type: application/json' \
-d '{"username":"<user>","password":"<password>"}'
curl -b cookies.txt -X POST \
https://<site-domain>/api/v1/api-tokens \
-H 'Content-Type: application/json' \
-d '{"name":"my-script","expires_in_days":180}'export DAISY_API_TOKEN=daisy_xxxxx export DAISY_API_BASE=https://<site-domain>/api/v1 curl -H "Authorization: Bearer $DAISY_API_TOKEN" \ "$DAISY_API_BASE/maintainer/software"
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /software | 已发布软件列表 |
| GET | /software/{slug} | 软件详情、截图、链接和维护者 |
| GET | /software/{slug}/versions | 版本、平台、大小和 SHA-256 |
| GET | /downloads | 全站可下载安装包 |
| POST | /download-links | 申请限时签名下载链接 |
| 方法 | 路径 | Scope | 说明 |
|---|---|---|---|
| GET | /maintainer/software | software:read | 当前用户可维护的软件 |
| GET | /maintainer/software/{slug} | software:read | 完整软件信息、媒体和安装包 |
| PATCH | /maintainer/software/{slug} | software:write | 修改软件信息 |
| PUT | /maintainer/software/{slug}/beamlines | software:write | 设置适用线站 |
| POST | /maintainer/software/{slug}/media | media:write | 上传封面、截图或说明书 |
| POST | /maintainer/software/{slug}/artifacts | artifact:write | 上传安装包 |
| PATCH | /maintainer/artifacts/{id} | artifact:write | 修改安装包信息 |
| POST | /maintainer/artifacts/{id}/yank | artifact:write | 下线安装包 |
list 和 get 无需 Token,update 才需要 Bearer Token。统一向 /maintainer/action 发送 POST JSON。
# 获取
curl -X POST https://<site-domain>/api/v1/maintainer/action \
-H "Content-Type: application/json" \
-d '{"action":"get","slug":"daisy-xrs"}'
# 修改
curl -X POST https://<site-domain>/api/v1/maintainer/action \
-H "Authorization: Bearer daisy_xxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"action":"update",
"slug":"daisy-xrs",
"fields":{"summary_zh":"新的软件简介"}
}'
# 需要下载物或媒体时显式开启
curl -X POST https://<site-domain>/api/v1/maintainer/action \
-H "Content-Type: application/json" \
-d '{
"action":"get",
"slug":"daisy-xrs",
"include_artifacts":true,
"include_media":true
}'需要重新获取软件数据?返回 软件清单。