殺戮尖塔2 (STS2) 開發者

安裝

<script src="https://spire-codex.com/widget/spire-codex-tooltip.js"></script>

語法

安裝

<div id="scx-changelog"></div>
<script src="https://spire-codex.com/widget/spire-codex-changelog.js"></script>

速率限制

所有上限按端點計算：表格是你在每條路由上的配額，而不是全域池。少數重型端點有自己的預算，無論是否使用金鑰都對所有呼叫者生效（見下方的對局匯出；語言 ZIP 為每小時 10 次）。關注 X-RateLimit-Remaining，遇到 429 時退避（會設定 Retry-After）。

批次匯出對局

GET /api/exports/runs?limit=1000&start=2026-06-01T00:00:00Z

以 JSONL 串流輸出官方對局，每行一局。

該端點有自己的預算，每小時 120 點，帶金鑰和匿名呼叫者共享：分頁請求消耗 1 點，無限制拉取（不帶 limit）消耗 60 點。因此持續同步最好用間隔約 30 秒的分頁拉取；遇到 429 時遵守 Retry-After，並用同一個 cursor 繼續。

需要完整資料？不帶參數的呼叫會重新導向到每天重建一次的靜態檔案 /exports/runs-latest.jsonl.gz，行格式相同；/api/exports/runs/manifest 給出產生時間和對局數量。每行包含 player_token，即提交帳戶的穩定化名 ID，匿名對局為 null。

只要某個補丁？/api/exports/runs?version=v0.111.0 會重新導向到 manifest 的 versions 表中對應版本的靜態檔案 /exports/runs-v0.111.0.jsonl.gz；搭配 limit 和 cursor 則改為對單一補丁分頁拉取。

基礎 URL

Beta 頻道（來自 Steam beta 分支的未發布內容）：在任意實體端點上加上： ?channel=beta. 目前 beta 版本： /api/beta/version. 與 main 的完整差異： /api/beta/diff.

端點

完整互動式文件（由後端自動產生，始終最新）： /docs

多語言

在任意端點上加上此查詢參數： ?lang=jpn. 支援 15 種語言：

eng, deu, esp, fra, ita, jpn, kor, pol, ptb, rus, spa, tha, tur, zhs, zht

預覽

Ironclad / Attack / Common

Silent / Skill / Uncommon

Defect / Power / Rare

Necrobinder / Skill / Rare

Regent / Attack / Uncommon

Curse

Event

Quest

精靈圖資源

全部 10 個 PNG 均啟用 CORS，把基礎 URL 放在每個檔名前即可。每個精靈圖為 128×128、RGBA、透明底白色（用於透過 CSS 上色）。

https://spire-codex.com/static/images/ui/run_history_card/
  card_back.png           ← tinted by pool
  desc_box.png            ← dark description area (render at 25% opacity)
  attack_portrait.png     ← portrait per card type
  attack_portrait_shadow.png
  skill_portrait.png
  skill_portrait_shadow.png
  power_portrait.png
  power_portrait_shadow.png
  banner_shadow.png       ← render at 60% opacity
  banner.png              ← tinted by rarity

卡池（卡背）顏色

來源： CardPoolModel.DeckEntryCardColor. 將它們與 /api/cards 回傳的 color 欄位對應。

稀有度（橫幅）顏色

來源： NTinyCard.GetBannerColor. 與 rarity 欄位對應。

最簡 HTML + CSS 範例

肖像檔名： attack = 攻擊牌, power = 能力牌, skill = 其餘所有（技能、狀態、詛咒……）

<div class="tiny-card" style="
  --back: #D62000;   /* pool color, Ironclad */
  --banner: #FFDA36; /* rarity color, Rare */
  position: relative;
  width: 64px;
  height: 64px;
">
  <!-- 1. card back, tinted by pool -->
  <div class="layer" style="
    background-color: var(--back);
    mask: url(https://spire-codex.com/static/images/ui/run_history_card/card_back.png) center/contain no-repeat;
    -webkit-mask: url(https://spire-codex.com/static/images/ui/run_history_card/card_back.png) center/contain no-repeat;
  "></div>

  <!-- 2. description box -->
  <img class="layer" src="https://spire-codex.com/static/images/ui/run_history_card/desc_box.png" style="opacity:.25">

  <!-- 3. portrait shadow + portrait (attack/skill/power) -->
  <img class="layer" src="https://spire-codex.com/static/images/ui/run_history_card/attack_portrait_shadow.png">
  <img class="layer" src="https://spire-codex.com/static/images/ui/run_history_card/attack_portrait.png"
       style="filter: brightness(.95) sepia(.15)">

  <!-- 4. banner shadow + banner tinted by rarity -->
  <img class="layer" src="https://spire-codex.com/static/images/ui/run_history_card/banner_shadow.png" style="opacity:.6">
  <div class="layer" style="
    background-color: var(--banner);
    mask: url(https://spire-codex.com/static/images/ui/run_history_card/banner.png) center/contain no-repeat;
    -webkit-mask: url(https://spire-codex.com/static/images/ui/run_history_card/banner.png) center/contain no-repeat;
  "></div>
</div>

<style>
  .tiny-card .layer {
    position: absolute; inset: 0;
    width: 100%; height: 100%;
    object-fit: contain;
  }
</style>

提供 15 種語言。下載範例： 日語, 韓語, 中文, 法語, 德語