同步辐射光源数据分析软件平台
软件
全部软件浏览完整软件清单成像与相干衍射CT、Ptycho、BCDI、Holo衍射与散射PDF、SAXS、BMX、XPCS谱学与荧光XAS、XRF、XRS、PCA/LCF通用数据工具数据转换、裁剪与格式处理人工智能稀疏重建、模型训练与推理
下载
下载中心全部软件安装包下载与安装说明许可、校验和安装步骤
文档
文档中心全部文档入口软件手册各软件使用说明书API 使用指南公开与维护者 API下载与安装下载、校验与安装说明DAISY 用户文档 ↗框架与算法文档
动态团队关于DaisyTorch计算平台 ↗
English
DAISY 数据处理软件

HEPS DAISY 数据处理软件官方站点,提供软件介绍、在线使用入口与安装包下载。

站内导航
  • 软件
  • 下载
  • 文档
  • 动态
  • 团队
  • 关于Daisy
  • 后台管理
相关链接
  • Torch计算平台 ↗
中国科学院高能物理研究所 · HEPS 大数据中心
DAISY · API

API 使用指南

公开接口用于读取软件、版本和申请下载链接;软件维护者使用个人 Token 更新自己负责的软件、图片和安装包。

文档中心软件手册API 使用指南下载与安装

基础地址与认证

Base URL: https://<site-domain>/api/v1
Authorization: Bearer daisy_xxxxxxxxxxxxxxxxx

维护者先使用原有后台账号登录,创建个人 Token。Token 只在创建时显示一次,后台只保存哈希。

1. 登录并创建 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}'
2. 使用 Token
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/softwaresoftware:read当前用户可维护的软件
GET/maintainer/software/{slug}software:read完整软件信息、媒体和安装包
PATCH/maintainer/software/{slug}software:write修改软件信息
PUT/maintainer/software/{slug}/beamlinessoftware:write设置适用线站
POST/maintainer/software/{slug}/mediamedia:write上传封面、截图或说明书
POST/maintainer/software/{slug}/artifactsartifact:write上传安装包
PATCH/maintainer/artifacts/{id}artifact:write修改安装包信息
POST/maintainer/artifacts/{id}/yankartifact:write下线安装包

Python 示例

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
  }'

可选:查看 Python SDK ↗|完整 API 文档 ↗

需要重新获取软件数据?返回 软件清单。