Documentation Lichcards

Assistants IA & API

Trouvez des cartes à collectionner, cartes à l’unité, accessoires et jeux de société avec des données produit à jour. Ce guide aide les développeurs et assistants IA à explorer notre boutique et à interpréter correctement les informations.

  • Données produit publiques
  • Lecture sans clé API
  • Commerce Shopify

Bien commencer

Recherchez d’abord un produit, puis consultez la variante choisie. La page produit indique les caractéristiques, le contenu, la langue et l’état des cartes.

Rechercher des produits

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

Lire les produits et variantes

GET /fr/products/151-boite-de-deck-collection-ultra-premium.js

Lire la devise de votre session

GET /fr/cart.js

La spécification OpenAPI décrit les requêtes Shopify existantes. Les instructions pour agents et la découverte UCP restent les sources des fonctionnalités commerciales actuelles.

Langue, pays et prix

Conservez les mêmes réglages de langue et de pays pour toutes les requêtes. Une URL anglaise ne sélectionne pas automatiquement une livraison au Royaume-Uni. Les montants de l’API produit .js sont exprimés en centièmes : 295 signifie 2,95 dans la devise active. Les suggestions de recherche utilisent des chaînes décimales. Consultez la devise dans votre propre session /cart.js. Les frais de livraison, remises éventuelles et total sont déterminés au paiement.

Accès et fonctionnalités

Les trois requêtes GET de cette spécification OpenAPI ne nécessitent aucune clé API. Elles lisent les produits publics et résultats de recherche, ou uniquement votre propre session de panier. Elles ne donnent accès ni aux données clients, ni aux commandes, paiements ou administration. La spécification ne contient aucune opération d’écriture.

Gérer les erreurs

Vérifiez toujours le statut HTTP avant de lire le JSON. Des paramètres de recherche invalides renvoient une erreur JSON avec status, message et description. Un produit inconnu peut renvoyer une réponse 404 vide : recherchez le bon produit. Patientez en cas de 429 et respectez Retry-After s’il est fourni.

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

Achats via Shopify

Shopify publie les fonctionnalités actuelles via UCP. Consultez d’abord le document de découverte et suivez ses services, versions et exigences d’authentification. Pour un achat, utilisez la variante choisie, le pays et la devise de l’acheteur ; le paiement nécessite son accord.

Découverte UCP