Lichcards-Dokumentation

KI-Assistenten & API

Finde Sammelkarten, Einzelkarten, Zubehör und Brettspiele mit aktuellen Produktdaten. Dieser Leitfaden hilft Entwicklern und KI-Assistenten, unseren Shop zu durchsuchen und Informationen richtig zu verstehen.

  • Öffentliche Produktdaten
  • Lesen ohne API-Schlüssel
  • Shopify Commerce

Erste Schritte

Suche zuerst ein Produkt und lies dann die gewählte Variante. Auf der Produktseite findest du Spezifikationen, Inhalt, Sprache und Kartenzustand.

Produkte suchen

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

Produkte und Varianten lesen

GET /de/products/151-ultra-premium-kollektion-deck-box.js

Währung der eigenen Sitzung lesen

GET /de/cart.js

Die OpenAPI-Spezifikation beschreibt bestehende Shopify-Anfragen. Agent-Anweisungen und UCP-Discovery bleiben die Quelle für aktuelle Commerce-Möglichkeiten.

Sprache, Land und Preise

Verwende für alle Anfragen dieselbe Sprache und dasselbe Land. Eine englische URL wählt nicht automatisch den Versand nach Großbritannien. Geldwerte der Produkt-API mit .js werden in Hundertsteln angegeben: 295 bedeutet 2,95 in der aktiven Währung. Suchvorschläge verwenden Dezimalzeichenketten. Lies die Währung aus deiner eigenen /cart.js-Sitzung. Versand, mögliche Rabatte und Gesamtbetrag werden im Checkout bestimmt.

Zugriff und Möglichkeiten

Die drei GET-Anfragen dieser OpenAPI-Spezifikation benötigen keinen API-Schlüssel. Sie lesen öffentliche Produkte und Suchergebnisse oder ausschließlich die eigene Warenkorbsitzung. Sie gewähren keinen Zugriff auf Kundendaten, Bestellungen, Zahlungen oder Shop-Verwaltung. Die Spezifikation enthält keine Schreiboperationen.

Fehler behandeln

Prüfe vor dem Verarbeiten von JSON immer den HTTP-Status. Ungültige Suchparameter liefern einen JSON-Fehler mit status, message und description. Ein unbekanntes Produkt kann eine leere 404-Antwort liefern: suche erneut nach dem richtigen Produkt. Warte bei 429 und beachte Retry-After, falls vorhanden.

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

Einkäufe über Shopify

Shopify veröffentlicht die aktuellen Möglichkeiten über UCP. Lies zuerst das Discovery-Dokument und beachte die darin genannten Dienste, Versionen und Authentifizierung. Verwende beim Kauf die gewählte Variante sowie Land und Währung des Käufers; die Zahlung erfordert seine Zustimmung.

UCP-Discovery