Aller au contenu principal

Rechercher des cartes

GET /api/v1/catalog/search?q=charizard%204&zone=intl&limit=25
ParamètreObligatoireBornes
qOui2 à 200 caractères
zoneNonintl, jp, chn
setNonCode d’extension, au plus 50 caractères
limitNonEntier de 1 à 100, 25 par défaut

Correspondances​

Chaque mot doit apparaître dans le texte normalisé, dans n’importe quel ordre. La recherche inclut noms de cartes, noms/codes d’extensions, numéros imprimés, langues et alias. Les termes de trois caractères ou moins correspondent à des mots entiers : 4 ne correspond pas à 104.

Les résultats suivent l’ordre du numéro imprimé normalisé, pas la pertinence. La réponse est { data: Card[] }, sans total ni curseur de page suivante.

curl --fail-with-body --silent --show-error --get \
'https://kardilo.com/api/v1/catalog/search' \
-H "Authorization: Bearer ${KARDILO_ACCESS_TOKEN}" \
--data-urlencode 'q=charizard 4' \
--data-urlencode 'zone=intl' \
--data-urlencode 'limit=25'

MCP utilise search_cards avec query et setCode au lieu de q et set, et renvoie { cards: Card[] }.