Slay the Spire 2 (STS2) Geliştiriciler

Spire Codex verileriyle araçlar, botlar ve içerik oluşturun. Her şey ücretsiz ve açık.

İpucu Bileşeni

Herhangi bir web sitesine kartlar, kalıntılar ve iksirler için Wowhead tarzı üzerine gelince açılan ipuçları ekleyin. Tek bir script etiketi, sıfır bağımlılık.

Kurulum

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

Söz dizimi

[[Strike]]Kart ipucu (varsayılan tür)

[[card:Bash]]Kart (açık)

[[relic:Burning Blood]]Kalıntı

[[potion:Fire Potion]]İksir

[[character:Ironclad]]Karakter

[[monster:Jaw Worm]]Canavar

[[power:Strength]]Güç

[[event:Neow]]Etkinlik

[[encounter:Lagavulin]]Karşılaşma

[[enchantment:Sharp]]Büyü

[[keyword:Exhaust]]Anahtar kelime

[[orb:Lightning]]Küre

[[affliction:Bound]]Rahatsızlık

[[achievement:Minimalist]]Başarım

JavaScript API'si

SpireCodex.scan()Sayfayı yeni [[...]] kalıpları için yeniden tarar (SPA'lar için)

SpireCodex.scan(element)Belirli bir DOM öğesini tarar

Değişiklik Günlüğü Bileşeni

Sürüm geçişiyle Spire Codex güncelleme geçmişini gösteren kompakt, etkileşimli bir değişiklik günlüğü görüntüleyici gömün.

Kurulum

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

data-version="1.0.4"Belirli bir sürümü gösterir (varsayılan: en son)

REST API

Oyunun tüm veritabanına herkese açık bir REST API üzerinden erişilebilir. Kimlik doğrulama gerekmez: IP başına web sitesi kotası gezinmeyi ve ara sıra yapılan çağrıları karşılar; anahtarsız API kullanımı aşağıdaki temel oranı alır. Betikler ve araçlar için bir API anahtarı oluşturun ve X-API-Key başlığı olarak gönderin. Bir anahtar, isteklerinizi IP yerine kimliğe göre gruplar (ağlar arasında kararlıdır, aynı NAT arkasındaki diğer kullanıcılarla asla paylaşılmaz) ve kullanım takibi sağlar; katman sınırı uç nokta başına uygulanır. Yanıtlar, istekleri ayarlayabilmeniz için X-RateLimit-Remaining / X-RateLimit-Reset taşır.

Hız sınırları

Web Sitesi Trafiği	300/minute	IP başına
API anahtarı yok	15/minute
Kayıtlı Kullanıcı	60/minute	profilinizden oluşturun
Akademik	100/minute	talep üzerine verilir
Ücretli	120/minute	destekçiler

Tüm sınırlar uç nokta başına sayılır: tablo her rotadaki kotanızdır, küresel bir havuz değil. Birkaç ağır uç noktanın, anahtardan bağımsız olarak her çağırana uygulanan kendi bütçesi vardır (aşağıdaki koşu dışa aktarımına bakın; dil ZIP'i saatte 10). X-RateLimit-Remaining'i izleyin ve 429'da geri çekilin (Retry-After ayarlanır).

Toplu koşu dışa aktarımı

Mini Kart Sprite'ı

Oyunun koşu içi kart küçük resmini (Koşu Geçmişi / Oyun Bitti ekranlarında kullanılır) herhangi bir web projesinde yeniden oluşturun. CSS mask-image ile birleştirilmiş altı PNG katmanı; canvas yok, WebGL yok, yalnızca renklendirilmiş sprite'lar. Renkler doğrudan derlemesi çözülmüş oyun kodundan gelir: NTinyCard, CardPoolModel.DeckEntryCardColor.

Önizleme

Ironclad / Attack / Common

Veri Dışa Aktarımları

Tüm oyun verilerini tek bir ZIP arşivi olarak indirin. Her arşiv, her varlık türü için (kartlar, kalıntılar, canavarlar, güçler ve daha fazlası) JSON dosyaları içerir.

İngilizce Verileri İndir (ZIP)

15 dil mevcut. Örnek indirmeler: Japonca, Korece, Çince, Fransızca, Almanca

Etkileşimli API Belgeleri

Deneme özelliğiyle eksiksiz Swagger/OpenAPI belgeleri.

API Belgelerini Aç →

Açık Kaynak

Spire Codex açık kaynaklıdır. Veri çıkarma hattı, API ve ön uç GitHub'da mevcuttur.

GitHub'da görüntüle →

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

Resmi koşuları JSONL olarak akıtır, satır başına bir koşu.

limit Sayfayı sınırlar; dolu bir sayfa bir sonraki için imleç döndürür.

start / end Yarı açık bir gönderim zamanı penceresiyle sınırlar. Sayfalarken sabit tutun; imleç bunları içermez.

Bu uç noktanın saatte 120 kredilik kendi bütçesi vardır ve anahtarlı ya da anonim tüm çağıranlar tarafından paylaşılır: sayfalanmış bir istek 1 kredi, sınırsız bir çekim (limit yok) 60 kredi tutar. Bu yüzden sürekli eşitleme en iyi ~30 sn aralıklı sayfalanmış çekimlerle çalışır; 429'da Retry-After'a uyun ve aynı imleçle devam edin.

Temel URL

https://spire-codex.com

Beta kanalı (Steam beta dalındaki yayınlanmamış içerik): bunu herhangi bir varlık uç noktasına ekleyin: ?channel=beta. Geçerli beta sürümü: /api/beta/version. Main ile tam fark: /api/beta/diff.

Uç noktalar

Tam etkileşimli belgeler (arka uçtan otomatik üretilir, her zaman güncel): /docs

Varlıklar

GET/api/cardsTüm kartlar (filtre: color, type, rarity, keyword, tag, spawns, search)

GET/api/cards/{id}Tek kart

GET/api/charactersTüm karakterler

GET/api/characters/{id}Tek karakter

GET/api/relicsTüm kalıntılar (filtre: rarity, pool, ancient, search)

GET/api/relics/{id}Tek kalıntı

GET/api/potionsTüm iksirler (filtre: rarity, pool, search)

GET/api/potions/{id}Tek iksir

GET/api/monstersTüm canavarlar (filtre: type, search)

GET/api/monsters/{id}Tek canavar

GET/api/powersTüm güçler (filtre: type, stack_type, search)

GET/api/powers/{id}Tek güç

GET/api/eventsTüm olaylar (filtre: type, act, search)

GET/api/events/{id}Tek olay

GET/api/encountersTüm karşılaşmalar (filtre: room_type, act, search)

GET/api/encounters/{id}Tek karşılaşma

GET/api/enchantmentsTüm büyüler

GET/api/enchantments/{id}Tek büyü

GET/api/keywordsKart anahtar sözcükleri

GET/api/keywords/{id}Tek anahtar sözcük

GET/api/intentsTüm niyet türleri

GET/api/intents/{id}Tek niyet

GET/api/orbsTüm küre türleri

GET/api/orbs/{id}Tek küre

GET/api/afflictionsIllet türleri

GET/api/afflictions/{id}Tek illet

GET/api/modifiersÖzel mod değiştiricileri

GET/api/modifiers/{id}Tek değiştirici

GET/api/achievementsTüm başarımlar

GET/api/achievements/{id}Tek başarım

GET/api/badgesTüm rozetler

GET/api/badges/{id}Tek rozet

GET/api/epochsTüm çağlar

GET/api/epochs/{id}Tek çağ

GET/api/storiesTüm hikâyeler

GET/api/stories/{id}Tek hikâye

GET/api/actsTüm perdeler

GET/api/acts/{id}Tek perde

GET/api/ascensionsTüm yükselme seviyeleri

GET/api/ascensions/{id}Tek yükselme

GET/api/glossaryTüm sözlük terimleri

GET/api/glossary/{id}Tek terim

Toplamalar ve Aramalar

GET/api/statsVarlık sayıları

GET/api/ancient-poolsKoşullarıyla tüm kadim kalıntı havuzları

GET/api/ancient-pools/{id}Tek bir kadimin havuzları

GET/api/unlocksÇağ bağlamıyla türe göre gruplanmış açılabilir varlıklar

GET/api/history/{entity_type}/{entity_id}Değişiklik günlüklerinden varlık başına sürüm geçmişi

GET/api/update-history/{entity_type}/{entity_id}Oyun yaması bazında varlık başına güncelleme geçmişi

GET/api/names/{entity_type}/{entity_id}Bir varlık için diller arası ad arama

GET/api/searchVarlıklar, referans girdileri, mekanikler, rehberler ve haberler genelinde birleşik site araması (q, lang)

GET/api/changelogsTüm değişiklik günlükleri

Topluluk ve Gönderimler

GET/api/guidesTüm rehberler (filtre: category, difficulty, tag, search)

GET/api/guides/{slug}İşlenmiş markdown ile tek rehber

POST/api/guidesRehber gönder (Discord webhook, hız sınırlı)

POST/api/runsTopluluk istatistikleri ve liderlik tabloları için koşu gönder

POST/api/runs/claimDaha önce gönderilen koşulara hash ile kullanıcı adı ekle

GET/api/runs/listGönderilen koşulara filtre ve sayfalamayla göz atın (gönderenin kazanma oranına göre ascension_min/ascension_max ve winrate_min/winrate_max dahil, yani içerik dilimleri)

GET/api/runs/leaderboardKoşu liderlik tabloları (fastest, highest_ascension); character, players, game_mode, ascension_min, winrate_min ile filtreleyin (içerik dilimleri)

GET/api/runs/shared/{run_hash}Hash ile tek gönderilmiş koşu (hız sınırlı)

GET/api/runs/stats

Toplu İndirmeler

GET/api/runs/exportResmi koşuların JSONL akışı (limit/start/end/cursor sayfalama; saatte 120 kredilik kendi bütçesi, yukarıdaki toplu koşu dışa aktarımına bakın)

GET/api/exports/{lang}Tek bir dil için tüm varlık JSON'larının ZIP'i (saatte 10)

GET/api/imagesGörsel galerisi kategorileri

GET/api/images/searchDosya adına göre görsel ara

GET/api/images/game/{version}/{category}/browseTam bir varlık dökümünün klasörlerinde sayfalı gezinme (path, offset, limit)

GET/api/images/game/{version}/{category}/downloadBir döküm klasörünün dosyalarının ZIP'i (path; en fazla 2000 dosya)

Çoklu Dil

Bu sorgu parametresini herhangi bir uç noktaya ekleyin: ?lang=jpn. 15 dil desteklenir:

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

Hızlı Başlangıç

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

Sprite varlıkları

10 PNG'nin tamamı CORS etkin olarak sunulur; her dosya adının önüne temel URL'yi koyun. Her sprite 128×128, RGBA, saydam üzerine beyazdır (CSS ile renklendirilmek için).

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

Havuz (kart arkası) renkleri

Kaynak: CardPoolModel.DeckEntryCardColor. Bunları /api/cards tarafından döndürülen color alanıyla eşleştirin.

ironclad#D62000

silent#5EBD00

defect#3EB3ED

necrobinder#CD4EED

regent#E36600

colorless#A3A3A3

event#A3A3A3

curse#585B61

quest#24476A

status#FFFFFF

token#FFFFFF

Nadirlik (afiş) renkleri

Kaynak: NTinyCard.GetBannerColor. rarity alanıyla eşleştirin.

Basic#9C9C9C

Starter#9C9C9C

Common#9C9C9C

Uncommon#64FFFF

Rare#FFDA36

Curse#E669FF

Event#13BE1A

Ancient#13BE1A

Quest#F46836

Status#9C9C9C

Token#9C9C9C

En basit HTML + CSS tarifi

Portre dosya adı: attack = Saldırı kartları, power = Güç kartları, skill = diğer her şey (Beceri, Durum, Lanet, …)

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

React bileşeni

Doğrudan kullanılabilir React sürümü. Kaynak: 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" />

Tam kart görselleri

/api/cards içindeki her kart, oyunun işlediği tam kart için (çerçeve, çizim, afiş ve metin, tam olarak oyundaki gibi) kullanıma hazır iki URL içerir. Kadim kartlar animasyonlu webp'dir.

image_url_card — Temel kart. İşlenmiş görseli olmayan tek kart (mad_science) için null; orada image_url'ye (portre çizimi) geri dönün.
image_url_card_upg — Yükseltilmiş kart. Kartın yükseltmesi yoksa null.

// 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"
}

Yerelleştirilmiş görseller bir dil alt klasöründe bulunur, örneğin: cards-full/stable/jpn/bash.webp. 15 dilin tamamı mevcuttur.

Büyülü kart görselleri

Her kart ayrıca kurallara uygun olarak alabileceği her büyüyle, oyun içi büyü önizlemesinin çizdiği gibi (rozet, miktar ve eklenen kart metni) işlenir. URL'ler tek bir kalıbı izler:

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}: /api/enchantments ve /api/cards'tan küçük harfli kimlikler (ör. sharp, corrupted, sown).
Yalnızca geçerli kart ve büyü kombinasyonları vardır (dışa aktarım oyunun kendi uygulanabilirlik kurallarını kullanır), bu yüzden geçersiz bir kombinasyon 404 döner. /api/enchantments üzerindeki card_type / applicable_to alanları hangi kartların uygun olduğunu açıklar.
Her kombinasyon için temel ve yükseltilmiş varyantlar 14 dilin tamamında, büyü metni tamamen yerelleştirilmiş olarak mevcuttur.

GET/api/changelogs/recent-additionsAna sayfa şeridi için öne çıkarılan en yeni varlıklar

GET/api/changelogs/{tag}Etikete göre tek değişiklik günlüğü (ör. v1.0.20)

GET/api/newsSteam duyuruları (kalıcılık için yerel olarak yansıtılır)

GET/api/news/{gid}Temizlenmiş gövdeli tek haber makalesi

GET/api/versionsSürüm seçici için kullanılabilir beta veri sürümleri

Toplu topluluk istatistikleri (character, ascension, username ile filtreleyin)

GET/api/runs/community-statsEğlenceli topluluk veri setleri: olay karar dağılımları, en ölümcül karşılaşmalar, yükselme/karaktere göre kazanma oranları, rekorlar

GET/api/charts/meta/charts gezgini için grafik kaydı: kullanılabilir grafikler, filtreler, bölmeler ve koşu istatistikleri

GET/api/charts/{chart}Önceden toplanmış tek grafik (filtre: players, ascension, game_mode, username, split, çerçeve grafiklerinde bracket=a10|wr30|wr50|wr75, artı grafik başına parametreler)

GET/api/beta/diffGeçerli betanın varlık türü başına neler eklediği, değiştirdiği ve kaldırdığı; her BETA etiketini besler

GET/api/beta/versionGeçerli beta sürümü

GET/api/runs/scores/{type}Varlık başına Codex Score + Codex Elo (cards/relics/potions); ?bracket=a10|wr30|wr50|wr75 bir içerik dilimi içinde notlandırır (oyun içi mod aynısını ?stat_filter=a10|a10_wr30|a10_wr50|a10_wr75 ile gönderir); kalıntılar edinme perdesine göre sıralamak için ?act=1|2|3 kabul eder; ?character= o karakterin dilimine geçer (girdiler bir scope alanı kazanır)

GET/api/runs/leaderboard/seed-rankTek bir tohum için tohum + küresel sıralama (?seed=&steam_id=); kazanan koşu olmadan sıralama alanları null olur

POST/api/auth/steam/ticketBir Steamworks web kimlik doğrulama biletini site JWT'siyle değiştir (oyun içi sessiz oturum açma); sunucuda Steam anahtarı olana kadar 503

GET/api/runs/metrics/{type}Yoğun ölçüt tablosu: Codex Score, Codex Elo, kazanma oranı, seçim oranı, perde başına bölmeler; ?bracket=all|solo|2p|3p|4p|a10|daily|custom|wr30|wr50|wr75 (içerik dilimleri)

GET/api/runs/versionsGönderilmiş koşusu olan farklı oyun derleme kimlikleri

POST/api/feedbackGeri bildirim gönder (Discord webhook)