Card Database

Istruzioni complete

Consulta le carte, scarica i dati oppure collega Excel al catalogo aggiornato.

Consultare e scaricare le carte

Apri Card Database.
Cerca un nome, una tribù o un effetto e scegli tipo e stato collezionabile. Premi Applica filtri.
Premi Scarica CSV per Excel per ottenere la selezione, oppure Database JSON / API per leggere tutti i campi originali.
Premi Aggiorna dati per rileggere il catalogo. Per scaricare tutte le carte, svuota la ricerca, ripristina tutti i filtri e applicali.

Il catalogo comprende anche fusioni, eventi e contenuti futuri. Una carta marcata come collezionabile può richiedere progressione o non essere ancora ottenibile.

Collegare Excel ai dati aggiornati

Copia il link di CSV completo per Excel. Puoi anche copiare il link CSV dal catalogo dopo aver applicato i filtri.
In Excel per desktop apri Dati → Recupera dati → Da altre origini → Da Web e incolla il link.
Se Excel chiede come accedere, seleziona Anonimo: non serve una chiave API.
Nell'anteprima scegli UTF-8 (65001) e delimitatore punto e virgola (;). Poi seleziona Carica, oppure Trasforma dati per scegliere colonne e tipi.
Usa Dati → Aggiorna tutto per scaricare nuovamente i dati dallo stesso link. Nelle proprietà della query, se disponibili nella tua versione, puoi abilitare l'aggiornamento all'apertura o a intervalli.

Le voci di menu e le connessioni Web disponibili dipendono dalla versione di Excel. Se non trovi “Da Web”, scarica il CSV e importalo con Dati → Da testo/CSV, usando UTF-8 e punto e virgola.

Un CSV salvato sul computer è una copia al momento del download. L'aggiornamento dei dati richiede una connessione Web o un nuovo download; una connessione al file locale rilegge soltanto quel file.

API JSON e accesso diretto

Gli endpoint sono pubblici e in sola lettura, senza autenticazione. Puoi aprire i link, importarli in altri strumenti o leggerli tramite richieste GET. Sono supportati HEAD e la lettura da altri siti tramite CORS.

Per una singola carta sostituisci zeus con il suo key, rispettando maiuscole e minuscole e codificando il valore come segmento URL.

La risposta elenco contiene schemaVersion, balanceVersion, updatedAt, total (intero catalogo), count (risultati filtrati) e cards. La risposta singola contiene i metadati di versione e card.

L'accesso diretto consiste nell'esportazione JSON o CSV del catalogo. I dati personali dei giocatori e le credenziali del database restano privati.

Filtri negli URL

Aggiungi ? seguito da coppie nome=valore, separate da &. I filtri funzionano sugli elenchi JSON e sui CSV, compresi i link diretti.

q: ricerca in identificatore, nome, effetto, descrizione, tribù e saga, senza distinzione tra maiuscole e minuscole.
type: tipo esatto, per esempio creature, spell o weapon.
rarity: rarità esatta, per esempio common o legendary.
collectible=true oppure collectible=false: seleziona lo stato collezionabile.

Esempio: CSV delle creature collezionabili.

Per rimuovere i filtri usa il link senza query. Ogni valore può avere al massimo 200 caratteri; codifica spazi e caratteri speciali negli URL.

Significato dei campi CSV

Colonne esportate
Campo	Significato
`key, name, type`	Identificatore stabile, nome e tipo della carta.
`cost`	Costo in mana, distinto dal prezzo di negozio.
`attack, health, armor`	Attacco, salute e armatura, quando presenti.
`rarity, tribe, tribes`	Rarità, tribù principale ed elenco delle tribù.
`effect, effectText, text, description`	Identificatore dell'effetto, testi delle regole e descrizione della carta.
`shopPrice, maxCopies`	Prezzo di negozio quando definito e limite di copie.
`collectible`	Stato collezionabile. Quando il campo originale è assente, il CSV lo considera vero secondo la convenzione del gioco.
`expansion, saga, releaseStatus, unlockAfterChapter`	Espansione, saga, stato di rilascio e requisito di progressione, quando definiti.
`image`	Percorso dell'immagine della carta.
`parameters`	Oggetto JSON con tutti i campi aggiuntivi: effetti secondari, trigger, bonus, disponibilità e parametri delle meccaniche.
`balanceVersion, updatedAt`	Versione e data di pubblicazione del bilanciamento numerico.

I campi assenti sono vuoti, non zero. Gli array e gli oggetti sono scritti in JSON dentro una cella. Il file usa UTF-8 con BOM, punto e virgola, righe CRLF e campi tra virgolette. I testi che potrebbero essere interpretati come formule sono preceduti da un apostrofo.

Il JSON mantiene tutti i campi originali della carta. Per capire se una carta è ottenibile, verifica anche releaseStatus, unlockAfterChapter, shopAvailable e packEligible, quando presenti.

Aggiornamenti e versioni

Il catalogo legge la libreria con il bilanciamento corrente usata per le nuove partite. Gli aggiornamenti numerici vengono controllati a ogni richiesta, con un intervallo minimo di un secondo. Le modifiche alla libreria diventano disponibili dopo il deploy del backend.

I testi degli effetti sono quelli pubblicati nella libreria; per i calcoli usa i parametri numerici correnti. updatedAt indica la pubblicazione del bilanciamento numerico, non l'ora del download o necessariamente l'ultima modifica ai testi.

L'API invia un ETag che identifica l'intera risposta, inclusi i testi. Una richiesta con If-None-Match può ricevere HTTP 304 se i dati non sono cambiati. La versione è disponibile anche nell'header X-Balance-Version.

Problemi comuni

Tutto in una colonna: importa il file tramite Da testo/CSV e scegli il delimitatore punto e virgola.
Accenti errati: seleziona UTF-8 (65001) durante l'importazione.
Dati non aggiornati: verifica che la query Excel punti al link Web, poi usa Aggiorna tutto. Un file locale richiede un nuovo download.
Elenco vuoto: rimuovi i filtri; tipo e rarità devono corrispondere ai valori presenti nel catalogo.
HTTP 400: controlla i nomi dei filtri e usa soltanto true oppure false per collectible.
HTTP 404 su una carta: controlla il key, le maiuscole e la codifica del segmento URL.
Catalogo non disponibile: riprova con Aggiorna dati; il primo avvio del server può richiedere qualche istante.