Rechercher des cartes
GET /api/v1/catalog/search?q=charizard%204&zone=intl&limit=25
| Paramètre | Obligatoire | Bornes |
|---|---|---|
q | Oui | 2 à 200 caractères |
zone | Non | intl, jp, chn |
set | Non | Code d’extension, au plus 50 caractères |
limit | Non | Entier 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[] }.