# ① 换取短期访问令牌（缓存复用，2 小时有效）
curl -X POST https://api.cleerscience.com/v1/token \
  -H "Content-Type: application/json" \
  -d '{"grant_type": "client_credentials",
       "app_id": "app_xxx", "app_secret": "您的AppSecret"}'
→ {"access_token": "at-…", "expires_in": 7200}

# ② 上传文件（申报 SHA-256，分片直传对象存储）
curl -X POST https://api.cleerscience.com/v1/uploads \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"filename": "sample.xrdml", "content_type": "application/xml",
       "size": 102400, "sha256": "文件内容SHA-256"}'
→ {"upload_id": "upl_…", "part_size_bytes": 8388608, "total_parts": 1}

# ③ 完成上传（校验通过，获得资产引用）
curl -X POST …/v1/uploads/upl_…/complete …
→ {"asset_ref": {"asset_id": "ast_…", "version": 1}, "status": "ready"}

# ④ 发起分析（XRD 物相检索）
curl -X POST …/v1/analyses \
  -H "Authorization: Bearer $TOKEN" -H "Idempotency-Key: $(uuidgen)" \
  -d '{"algorithm_id": "xrd-phase-analysis",
       "inputs": [{"asset_id": "ast_…", "version": 1}]}'
→ 202 {"analysis_id": "run_…", "status": "queued"}

# ⑤ 轮询至终态，读取结果信封与产物下载地址
curl …/v1/analyses/run_… -H "Authorization: Bearer $TOKEN"
curl …/v1/analyses/run_…/result -H "Authorization: Bearer $TOKEN"

{
  "status": "waiting_for_input",
  "interaction": {
    "interaction_id": "itx_…",
    "form": {
      "fields": [
        { "key": "precursor_mz", "type": "number",
          "label": "前体离子 m/z" },
        { "key": "ion_mode", "type": "single_choice",
          "options": ["positive", "negative"] }
      ]
    },
    "expires_at": "2026-09-17T10:30:00Z"
  }
}

{
  "analysis_id": "run_…",
  "algorithm": {"id": "xrd-phase-analysis", "version": "0.7.0"},
  "status": "succeeded",
  "created_at": "2026-09-17T08:30:12Z",
  "finished_at": "2026-09-17T08:31:40Z",
  "inputs": [{ "asset_id": "ast_…", "version": 1,
                "filename": "sample.xrdml", "sha256": "9f2c…" }],
  "result": { "schema_version": "0.7", /* 算法指标，按算法版本化 */ },
  "artifacts": [{ "type": "report", "filename": "report.pdf",
                   "sha256": "e3b0…", "download_url": "https://…（限时）" }],
  "answers": [],
  "usage": { "compute_seconds": 88 }
}