Slay the Spire 2 (STS2) Deweloperzy

Twórz narzędzia, boty i treści z danymi Spire Codex. Wszystko jest darmowe i otwarte.

Widżet podpowiedzi

Dodaj podpowiedzi po najechaniu w stylu Wowhead dla kart, reliktów i mikstur na dowolnej stronie. Jeden tag script, zero zależności.

Instalacja

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

Składnia

[[Strike]]Podpowiedź karty (typ domyślny)

[[card:Bash]]Karta (jawnie)

[[relic:Burning Blood]]Relikt

[[potion:Fire Potion]]Mikstura

[[character:Ironclad]]Postać

[[monster:Jaw Worm]]Potwór

[[power:Strength]]Moc

[[event:Neow]]Wydarzenie

[[encounter:Lagavulin]]Starcie

[[enchantment:Sharp]]Zaklęcie

[[keyword:Exhaust]]Słowo kluczowe

[[orb:Lightning]]Kula

[[affliction:Bound]]Dolegliwość

[[achievement:Minimalist]]Osiągnięcie

API JavaScript

SpireCodex.scan()Ponownie skanuje stronę w poszukiwaniu nowych wzorców [[...]] (dla SPA)

SpireCodex.scan(element)Skanuje konkretny element DOM

Widżet listy zmian

Osadź kompaktową, interaktywną przeglądarkę listy zmian pokazującą historię aktualizacji Spire Codex z przełączaniem wersji.

Instalacja

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

data-version="1.0.4"Pokazuje konkretną wersję (domyślnie: najnowsza)

REST API

Pełna baza danych gry dostępna przez publiczne REST API. Bez uwierzytelniania: limit strony na IP pokrywa przeglądanie i okazjonalne wywołania, a użycie API bez klucza dostaje bazowy limit poniżej. Do skryptów i narzędzi utwórz klucz API i wysyłaj go w nagłówku X-API-Key. Klucz grupuje twoje żądania według tożsamości zamiast IP (stabilnie między sieciami, nigdy niedzielony z innymi użytkownikami za tym samym NAT) i daje śledzenie użycia; limit jego poziomu obowiązuje per endpoint. Odpowiedzi zawierają X-RateLimit-Remaining / X-RateLimit-Reset, żebyś mógł dawkować żądania.

Limity żądań

Ruch na stronie	300/minute	na IP
Bez klucza API	15/minute
Zarejestrowany użytkownik	60/minute	utwórz w swoim profilu
Akademicki	100/minute	przyznawany na prośbę
Płatny	120/minute	wspierający

Wszystkie limity liczą się per endpoint: tabela to twój przydział na każdej trasie, nie globalna pula. Kilka ciężkich endpointów ma własne budżety, które obowiązują każdego wywołującego niezależnie od klucza (zob. eksport rozgrywek poniżej; ZIP językowy to 10/godz.). Obserwuj X-RateLimit-Remaining i wstrzymaj się przy 429 (ustawiany jest Retry-After).

Masowy eksport rozgrywek

Sprite miniaturowej karty

Odtwórz miniaturę karty z gry (używaną na ekranach Historii rozgrywek / Game Over) w dowolnym projekcie webowym. Sześć warstw PNG złożonych przez CSS mask-image, bez canvas, bez WebGL, tylko barwione sprite'y. Kolory pochodzą prosto ze zdekompilowanego kodu gry: NTinyCard, CardPoolModel.DeckEntryCardColor.

Podgląd

Ironclad / Attack / Common

Eksport danych

Pobierz wszystkie dane gry jako jedno archiwum ZIP. Każde archiwum zawiera pliki JSON dla każdego typu encji (karty, relikty, potwory, moce i więcej).

Pobierz dane po angielsku (ZIP)

Dostępnych 15 języków. Przykładowe pobrania: Japoński, Koreański, Chiński, Francuski, Niemiecki

Interaktywna dokumentacja API

Pełna dokumentacja Swagger/OpenAPI z możliwością wypróbowania.

Otwórz dokumentację API →

Open source

Spire Codex jest open source. Pipeline ekstrakcji danych, API i frontend są dostępne na GitHubie.

Zobacz na GitHubie →

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

Strumieniuje oficjalne rozgrywki jako JSONL, jedna rozgrywka na wiersz.

limit Ogranicza stronę; pełna strona zwraca kursor do następnej.

start / end Ograniczają do półotwartego okna daty przesłania. Utrzymuj je stałe podczas stronicowania; kursor ich nie zawiera.

Ten endpoint ma własny budżet 120 kredytów na godzinę, wspólny dla wywołujących z kluczem i bez: żądanie stronicowane kosztuje 1 kredyt, pobranie bez limitu kosztuje 60. Ciągła synchronizacja działa więc najlepiej jako stronicowane pobrania co ~30 s; przy 429 respektuj Retry-After i wznów z tym samym kursorem.

Bazowy URL

https://spire-codex.com

Kanał beta (niewydane treści z gałęzi beta Steam): dodaj to do dowolnego endpointu encji: ?channel=beta. Aktualna wersja beta: /api/beta/version. Pełna różnica względem main: /api/beta/diff.

Endpointy

Pełna interaktywna dokumentacja (generowana automatycznie z backendu, zawsze aktualna): /docs

Encje

GET/api/cardsWszystkie karty (filtry: color, type, rarity, keyword, tag, spawns, search)

GET/api/cards/{id}Pojedyncza karta

GET/api/charactersWszystkie postacie

GET/api/characters/{id}Pojedyncza postać

GET/api/relicsWszystkie relikty (filtry: rarity, pool, ancient, search)

GET/api/relics/{id}Pojedynczy relikt

GET/api/potionsWszystkie mikstury (filtry: rarity, pool, search)

GET/api/potions/{id}Pojedyncza mikstura

GET/api/monstersWszystkie potwory (filtry: type, search)

GET/api/monsters/{id}Pojedynczy potwór

GET/api/powersWszystkie moce (filtry: type, stack_type, search)

GET/api/powers/{id}Pojedyncza moc

GET/api/eventsWszystkie wydarzenia (filtry: type, act, search)

GET/api/events/{id}Pojedyncze wydarzenie

GET/api/encountersWszystkie starcia (filtry: room_type, act, search)

GET/api/encounters/{id}Pojedyncze starcie

GET/api/enchantmentsWszystkie zaklęcia

GET/api/enchantments/{id}Pojedyncze zaklęcie

GET/api/keywordsSłowa kluczowe kart

GET/api/keywords/{id}Pojedyncze słowo kluczowe

GET/api/intentsWszystkie typy zamiarów

GET/api/intents/{id}Pojedynczy zamiar

GET/api/orbsWszystkie typy kul

GET/api/orbs/{id}Pojedyncza kula

GET/api/afflictionsTypy dolegliwości

GET/api/afflictions/{id}Pojedyncza dolegliwość

GET/api/modifiersModyfikatory trybu niestandardowego

GET/api/modifiers/{id}Pojedynczy modyfikator

GET/api/achievementsWszystkie osiągnięcia

GET/api/achievements/{id}Pojedyncze osiągnięcie

GET/api/badgesWszystkie odznaki

GET/api/badges/{id}Pojedyncza odznaka

GET/api/epochsWszystkie epoki

GET/api/epochs/{id}Pojedyncza epoka

GET/api/storiesWszystkie historie

GET/api/stories/{id}Pojedyncza historia

GET/api/actsWszystkie akty

GET/api/acts/{id}Pojedynczy akt

GET/api/ascensionsWszystkie poziomy ascensji

GET/api/ascensions/{id}Pojedyncza ascensja

GET/api/glossaryWszystkie hasła słownika

GET/api/glossary/{id}Pojedyncze hasło

Agregacje i wyszukiwania

GET/api/statsLiczba encji

GET/api/ancient-poolsWszystkie pule reliktów starożytnych z warunkami

GET/api/ancient-pools/{id}Pule jednego starożytnego

GET/api/unlocksOdblokowywalne encje pogrupowane według typu z kontekstem epoki

GET/api/history/{entity_type}/{entity_id}Historia wersji per encja na podstawie list zmian

GET/api/update-history/{entity_type}/{entity_id}Historia aktualizacji per encja według łatek gry

GET/api/names/{entity_type}/{entity_id}Wyszukiwanie nazwy encji we wszystkich językach

GET/api/searchZunifikowane wyszukiwanie w witrynie po encjach, hasłach referencyjnych, mechanikach, poradnikach i newsach (q, lang)

GET/api/changelogsWszystkie listy zmian

Społeczność i zgłoszenia

GET/api/guidesWszystkie poradniki (filtry: category, difficulty, tag, search)

GET/api/guides/{slug}Pojedynczy poradnik z wyrenderowanym markdownem

POST/api/guidesPrześlij poradnik (webhook Discord, z limitem żądań)

POST/api/runsPrześlij rozgrywkę do statystyk społeczności i rankingów

POST/api/runs/claimPrzypisz nazwę użytkownika do wcześniej przesłanych rozgrywek po hashu

GET/api/runs/listPrzeglądaj przesłane rozgrywki z filtrami i stronicowaniem (w tym ascension_min/ascension_max oraz winrate_min/winrate_max według współczynnika zwycięstw zgłaszającego, przedziały treści)

GET/api/runs/leaderboardRankingi rozgrywek (fastest, highest_ascension); filtruj po character, players, game_mode, ascension_min, winrate_min (przedziały treści)

GET/api/runs/shared/{run_hash}Pojedyncza przesłana rozgrywka po hashu (z limitem żądań)

GET

Pobieranie masowe

GET/api/runs/exportStrumień JSONL oficjalnych rozgrywek (stronicowanie limit/start/end/cursor; własny budżet 120 kredytów na godzinę, zob. masowy eksport powyżej)

GET/api/exports/{lang}ZIP ze wszystkimi JSON encji dla jednego języka (10/godz.)

GET/api/imagesKategorie galerii obrazów

GET/api/images/searchSzukaj obrazów po nazwie pliku

GET/api/images/game/{version}/{category}/browseStronicowane przeglądanie folderów pełnego zrzutu zasobów (path, offset, limit)

GET/api/images/game/{version}/{category}/downloadZIP z plikami jednego folderu zrzutu (path; maksymalnie 2000 plików)

Wielojęzyczność

Dodaj ten parametr zapytania do dowolnego endpointu: ?lang=jpn. Obsługiwanych jest 15 języków:

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

Szybki start

cURL

curl https://spire-codex.com/api/cards?color=ironclad&rarity=Rare

Python

import requests
cards = requests.get("https://spire-codex.com/api/cards", params={"color": "ironclad"}).json()
for card in cards:
    print(f"{card['name']} - {card['type']} ({card['rarity']})")

JavaScript

const res = await fetch("https://spire-codex.com/api/relics?pool=ironclad");
const relics = await res.json();
console.log(relics.map(r => r.name));

Silent / Skill / Uncommon

Defect / Power / Rare

Necrobinder / Skill / Rare

Regent / Attack / Uncommon

Zasoby sprite'ów

Wszystkie 10 PNG jest serwowanych z włączonym CORS, wstaw bazowy URL przed każdą nazwą pliku. Każdy sprite ma 128×128, RGBA, biały na przezroczystym (do barwienia przez 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

Kolory puli (rewers karty)

Źródło: CardPoolModel.DeckEntryCardColor. Dopasuj je do pola color zwracanego przez /api/cards.

ironclad#D62000

silent#5EBD00

defect#3EB3ED

necrobinder#CD4EED

regent#E36600

colorless#A3A3A3

event#A3A3A3

curse#585B61

quest#24476A

status#FFFFFF

token#FFFFFF

Kolory rzadkości (baner)

Źródło: NTinyCard.GetBannerColor. Dopasuj do pola rarity.

Basic#9C9C9C

Starter#9C9C9C

Common#9C9C9C

Uncommon#64FFFF

Rare#FFDA36

Curse#E669FF

Event#13BE1A

Ancient#13BE1A

Quest#F46836

Status#9C9C9C

Token#9C9C9C

Minimalny przepis HTML + CSS

Nazwa pliku portretu: attack = Karty Ataku, power = Karty Mocy, skill = cała reszta (Umiejętność, Stan, Klątwa, …)

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

Komponent React

Gotowa do użycia wersja React. Źródło: TinyCard.tsx

import TinyCard from "./TinyCard";

// Feed in the three fields from /api/cards:
<TinyCard color="ironclad" type="Attack" rarity="Rare" className="w-16 h-16" />

Pełne obrazy kart

Każda karta z /api/cards zawiera dwa gotowe adresy URL pełnej karty wyrenderowanej przez grę (ramka, grafika, baner i tekst, dokładnie jak w grze). Karty starożytnych to animowane webp.

image_url_card — Karta bazowa. null dla jedynej karty bez renderu (mad_science); wtedy użyj image_url (grafiki portretu).
image_url_card_upg — Karta ulepszona. null, gdy karta nie ma ulepszenia.

// e.g. /api/cards/bash
{
  "id": "BASH",
  "image_url":          "/static/images/cards/bash.webp",  // portrait art
  "image_url_card":     "https://cdn.spire-codex.com/cards-full/stable/bash.webp",
  "image_url_card_upg": "https://cdn.spire-codex.com/cards-full/stable/bash_upg.webp"
}

Zlokalizowane rendery znajdują się w podfolderze języka, na przykład: cards-full/stable/jpn/bash.webp. Dostępnych jest wszystkie 15 języków.

Rendery zaklętych kart

Każda karta jest też renderowana z każdym zaklęciem, które może legalnie otrzymać, dokładnie tak, jak rysuje ją podgląd zaklęcia w grze (odznaka, wartość i dodany tekst karty). Adresy URL mają jeden schemat:

https://cdn.spire-codex.com/cards-full/stable/ench/{enchantment}/{card}.webp        // English, base
https://cdn.spire-codex.com/cards-full/stable/ench/{enchantment}/{card}_upg.webp    // English, upgraded
https://cdn.spire-codex.com/cards-full/stable/{lang}/ench/{enchantment}/{card}.webp // localized

// e.g. Anger with Corrupted, in Japanese:
https://cdn.spire-codex.com/cards-full/stable/jpn/ench/corrupted/anger.webp

{enchantment} / {card}: identyfikatory małymi literami z /api/enchantments i /api/cards (np. sharp, corrupted, sown).
Istnieją tylko prawidłowe kombinacje karty i zaklęcia (eksport używa reguł stosowalności samej gry), więc nieprawidłowa kombinacja zwraca 404. Pola card_type / applicable_to w /api/enchantments opisują, które karty się kwalifikują.
Dla każdej kombinacji istnieją warianty bazowy i ulepszony, we wszystkich 14 językach, z w pełni zlokalizowanym tekstem zaklęcia.

GET/api/changelogs/recent-additionsNajnowsze encje pokazywane w pasku na stronie głównej

GET/api/changelogs/{tag}Pojedyncza lista zmian według tagu (np. v1.0.20)

GET/api/newsOgłoszenia Steam (kopiowane lokalnie dla trwałości)

GET/api/news/{gid}Pojedynczy artykuł z oczyszczoną treścią

GET/api/versionsDostępne wersje danych beta dla wyboru wersji

Zagregowane statystyki społeczności (filtruj po character, ascension, username)

GET/api/runs/community-statsCiekawe zbiory danych społeczności: podział decyzji w wydarzeniach, najbardziej zabójcze starcia, współczynniki zwycięstw według ascensji/postaci, rekordy

GET/api/charts/metaRejestr wykresów dla eksploratora /charts: dostępne wykresy, filtry, podziały i statystyki rozgrywek

GET/api/charts/{chart}Jeden wstępnie zagregowany wykres (filtry: players, ascension, game_mode, username, split, bracket=a10|wr30|wr50|wr75 na wykresach ramowych, plus parametry per wykres)

GET/api/beta/diffCo aktualna beta dodaje, zmienia i usuwa per typ encji; zasila każdą etykietę BETA

GET/api/beta/versionAktualna wersja beta

GET/api/runs/scores/{type}Codex Score + Codex Elo per encja (cards/relics/potions); ?bracket=a10|wr30|wr50|wr75 ocenia w obrębie przedziału treści (mod w grze wysyła to samo przez ?stat_filter=a10|a10_wr30|a10_wr50|a10_wr75); relikty przyjmują ?act=1|2|3 do rankingu według aktu zdobycia; ?character= przełącza na wycinek tej postaci (wpisy zyskują pole scope)

GET/api/runs/leaderboard/seed-rankZiarno + globalna pozycja dla jednego ziarna (?seed=&steam_id=); pola rankingu są null bez wygranej rozgrywki

POST/api/auth/steam/ticketWymień bilet uwierzytelniający Steamworks na JWT witryny (ciche logowanie w grze); 503 dopóki serwer nie ma klucza Steam

GET/api/runs/metrics/{type}Gęsta tabela metryk: Codex Score, Codex Elo, współczynnik zwycięstw, częstość wyboru, podziały per akt; ?bracket=all|solo|2p|3p|4p|a10|daily|custom|wr30|wr50|wr75 (przedziały treści)

GET/api/runs/versionsUnikalne identyfikatory buildów gry z przesłanymi rozgrywkami

POST/api/feedbackPrześlij opinię (webhook Discord)