Lichcards documentatie

AI-assistenten & API

Vind trading cards, losse kaarten, accessoires en bordspellen met actuele productgegevens. Deze gids helpt ontwikkelaars en AI-assistenten om onze winkel te doorzoeken en informatie goed te interpreteren.

  • Openbare productgegevens
  • Lezen zonder API-sleutel
  • Shopify commerce

Snel beginnen

Zoek eerst een product en lees daarna de details van de gekozen variant. Gebruik de productpagina voor specificaties, inhoud, taal en kaartconditie.

Producten zoeken

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

Product en varianten lezen

GET /products/151-ultra-premium-collection-deck-box.js

Valuta van je eigen sessie lezen

GET /cart.js

De OpenAPI-specificatie beschrijft bestaande Shopify-verzoeken. De agentinstructies en UCP-ontdekking blijven de bron voor de actuele commerce-mogelijkheden.

Taal, land en prijzen

Gebruik dezelfde taal- en landinstelling voor alle verzoeken. Een Engelse URL betekent niet automatisch levering in het Verenigd Koninkrijk. De bedragen van de product-API met .js zijn geldwaarden in honderdsten: 295 is 2,95 in de actieve valuta. Zoeksuggesties gebruiken decimale tekenreeksen. Lees de valuta uit je eigen /cart.js-sessie. Verzendkosten, eventuele kortingen en het totaal worden in de checkout bepaald.

Toegang en mogelijkheden

Voor de drie GET-verzoeken in deze OpenAPI-specificatie is geen API-sleutel nodig. Ze lezen openbare producten en zoekresultaten, of uitsluitend je eigen winkelwagensessie. Ze geven geen toegang tot klantgegevens, bestellingen, betalingen of winkelbeheer. De specificatie bevat geen schrijfacties.

Fouten afhandelen

Controleer altijd de HTTP-status voordat je JSON verwerkt. Onjuiste zoekparameters leveren een JSON-fout met status, message en description op. Een onbekend product kan een lege 404-reactie geven: zoek dan het juiste product opnieuw. Wacht bij 429 en volg Retry-After als die aanwezig is.

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

Aankopen via Shopify

Shopify publiceert de actuele mogelijkheden via UCP. Lees eerst de ontdekkinginformatie en volg de vermelde service, versie en authenticatievereisten. Gebruik bij een aankoop de juiste variant, het land en de valuta van de koper; betaling vereist toestemming van de koper.

UCP-ontdekking