Recettes d’intégration

Construire un navigateur d’extensions

1. Appelez GET /catalog/sets.
2. Laissez la personne choisir une extension par son id retourné.
3. Encodez cet identifiant dans GET /catalog/sets/:code/cards.
4. Affichez nom, numéro, langue et variante. Prévoyez un remplacement si imageUrl est absent.
5. Paginez avec page et pageSize ; utilisez meta.total pour la navigation.

Un import peut modifier les résultats entre les pages. Conservez les identifiants lors du rapprochement et ne promettez pas un export intégral figé.

Résoudre une identité

Recherchez un nom de carte et son numéro imprimé. Ajoutez une zone ou un code d’extension si vous les connaissez. Demandez à la personne de choisir la bonne langue et impression, puis récupérez l’id sélectionné via l’endpoint de détail.

La recherche ne renvoie pas de score de confiance et ne garantit pas que le premier résultat soit le bon. Elle n’identifie pas de photo et ne retourne pas de prix.

Le même parcours utilise search_cards et get_card en MCP.