Documentazione Lichcards

Assistenti IA & API

Trova carte collezionabili, carte singole, accessori e giochi da tavolo con dati aggiornati. Questa guida aiuta sviluppatori e assistenti IA a cercare nel nostro negozio e interpretare correttamente le informazioni.

  • Dati pubblici dei prodotti
  • Lettura senza chiave API
  • Commercio Shopify

Per iniziare

Cerca prima un prodotto, poi leggi la variante scelta. La pagina prodotto riporta specifiche, contenuto, lingua e condizioni delle carte.

Cercare prodotti

GET /it/search/suggest.json?q=pokemon&resources%5Btype%5D=product&resources%5Blimit%5D=3

Leggere prodotti e varianti

GET /it/products/151-scatola-del-mazzo-di-raccolta-ultra-premium.js

Leggere la valuta della tua sessione

GET /it/cart.js

La specifica OpenAPI descrive richieste Shopify esistenti. Le istruzioni per gli agenti e la discovery UCP restano le fonti delle funzionalità commerciali attuali.

Lingua, paese e prezzi

Mantieni la stessa lingua e lo stesso paese per tutte le richieste. Un URL inglese non seleziona automaticamente la consegna nel Regno Unito. Gli importi dell’API prodotto .js sono espressi in centesimi: 295 significa 2,95 nella valuta attiva. I suggerimenti di ricerca usano stringhe decimali. Leggi la valuta dalla tua sessione /cart.js. Spedizione, eventuali sconti e totale sono determinati al checkout.

Accesso e funzionalità

Le tre richieste GET di questa specifica OpenAPI non richiedono una chiave API. Leggono prodotti pubblici e risultati di ricerca, oppure soltanto la tua sessione del carrello. Non danno accesso a dati dei clienti, ordini, pagamenti o amministrazione. La specifica non contiene operazioni di scrittura.

Gestire gli errori

Controlla sempre lo stato HTTP prima di elaborare JSON. Parametri di ricerca non validi restituiscono un errore JSON con status, message e description. Un prodotto sconosciuto può restituire una risposta 404 vuota: cerca il prodotto corretto. Attendi in caso di 429 e rispetta Retry-After se presente.

{
  "status": 422,
  "message": "Invalid parameter error",
  "description": "Type not supported."
}

Acquisti tramite Shopify

Shopify pubblica le funzionalità attuali tramite UCP. Leggi prima il documento di discovery e segui servizi, versioni e requisiti di autenticazione indicati. Per un acquisto, usa la variante scelta, il paese e la valuta dell’acquirente; il pagamento richiede la sua approvazione.

Discovery UCP