杀戮尖塔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 种语言。下载示例： 日语, 韩语, 中文, 法语, 德语