Scryfall

Scryfall est un moteur de recherche spécialisé et un service de données public pour Magic: The Gathering, le jeu de cartes à collectionner publié par Wizards of the Coast. Son site web permet aux utilisateurs de trouver des cartes parmi les extensions Magic, les éditions, les sorties promotionnelles et les produits numériques grâce à un langage de requête conçu pour la recherche sur les cartes. Les recherches peuvent cibler les noms, les types, le texte Oracle, les coûts de mana, la rareté, les artistes, les codes d’extension, les formats, l’identité couleur et le statut de légalité. Cela est particulièrement utile, car les cartes Magic sont fréquemment réimprimées avec des illustrations, des cadres, des numéros de collection ou une disponibilité modifiés. Scryfall distingue une carte de jeu de ses éditions individuelles, ce qui rend ces différences visibles aux collectionneurs du monde entier. Sur chaque page de carte, Scryfall fournit des informations structurées telles que le libellé Oracle actuel, le coût de mana, la ligne de type, le texte de règles, la force et l’endurance ou la loyauté, le cas échéant, ainsi que l’extension et le numéro de collection, le nom de l’artiste et la légalité dans les formats. Le texte Oracle est le libellé de référence maintenu par Wizards of the Coast ; l’afficher à côté d’éditions plus anciennes aide les utilisateurs à identifier les mises à jour des règles sans les confondre avec le texte imprimé d’origine. Le site relie également les éditions associées et indique si une carte est disponible en version papier, sur Magic Online ou sur Arena. La présentation comprend des images et des traitements, lorsqu’ils sont disponibles, tels que les versions sans bordure, showcase, illustration étendue et cadre rétro. Scryfall publie également une API REST permettant aux logiciels de récupérer des objets de carte en JSON. Les développeurs peuvent utiliser des points de terminaison pour une carte nommée, une carte aléatoire, des résultats de recherche, des collections de cartes, des extensions, des catalogues, des décisions de règles, des symboles et des métadonnées de données en masse. Les réponses de recherche sont paginées et incluent des liens vers les pages. Les objets de carte de l’API exposent des identifiants, des URI d’images lorsqu’elles sont disponibles, les légalités, les prix, les cartes et les éditions en langues étrangères. La page Bulk Data de Scryfall fournit des fichiers téléchargeables pour une utilisation à grande échelle, notamment les jeux de données Oracle Cards, Unique Artwork, Default Cards et All Cards. Ces versions permettent de créer localement des outils de construction de decks, des gestionnaires de collections, des projets statistiques ou des applications de consultation hors ligne. L’interface de Scryfall n’est pas un index de noms. Sa syntaxe prend en charge les requêtes de nom exact, les expressions régulières, les combinaisons booléennes, les opérateurs de comparaison et des qualificatifs tels que `is:commander`, `f:modern` ou `id:wu`. Un joueur peut donc demander une carte bleue et blanche légale en Modern ou trouver des cartes dont le texte Oracle contient une phrase donnée. Le service publie une documentation sur la syntaxe de recherche et une référence de l’API, aidant les utilisateurs à reproduire un résultat dans un navigateur ou un programme. Scryfall indique qu’il n’est ni produit par Wizards of the Coast, ni approuvé, soutenu ou affilié à cette société. Les noms, les illustrations et la propriété intellectuelle des cartes Magic restent associés à leurs détenteurs de droits respectifs.