슬레이 더 스파이어 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를 지키고 같은 커서로 재개하세요.

전체 데이터가 필요하면 매개변수 없는 호출이 하루 한 번 다시 생성되는 정적 파일 /exports/runs-latest.jsonl.gz 로 리디렉션되며, 줄 형식은 같습니다. /api/exports/runs/manifest 가 생성 시각과 런 수를 알려줍니다. 각 줄에는 제출 계정의 안정적인 가명 ID인 player_token 이 포함되며, 익명 런에서는 null 입니다.

한 패치만 필요하세요? /api/exports/runs?version=v0.111.0 은 매니페스트의 versions 맵에 있는 버전별 정적 파일 /exports/runs-v0.111.0.jsonl.gz 로 리디렉션됩니다. limit 및 cursor 와 함께 쓰면 해당 패치만 페이징합니다.

기본 URL

베타 채널(Steam 베타 브랜치의 미공개 콘텐츠): 어떤 엔티티 엔드포인트에든 이것을 붙이세요: ?channel=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

스프라이트 에셋

PNG 10개 모두 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개 언어 제공. 다운로드 예: 일본어, 한국어, 중국어, 프랑스어, 독일어