Scryfall

Scryfall est une base de données et un moteur de recherche en ligne pour les cartes de Magic : L'Assemblée, le jeu de cartes à collectionner publié par Wizards of the Coast. Ses pages de cartes rassemblent le texte Oracle, les impressions, les légalités, les décisions, les prix, les crédits des artistes, les numéros de collection, les finitions, les langues, les informations sur les extensions et des images de cartes en haute résolution. Le service identifie les impressions individuelles à l'aide d'identifiants stables de type UUID et représente les cartes au moyen d'une API publique documentée. Une distinction centrale sur Scryfall oppose l'objet carte à l'impression. Une recherche sur le nom d'une carte peut afficher de nombreuses éditions, tandis que le paramètre de recherche « unique » permet de contrôler si les résultats sont regroupés par cartes, illustrations ou impressions. Sa syntaxe prend en charge des requêtes spécifiques à certains champs, telles que `t:dragon`, `c:rw`, `o:flying` et `set:lea`, ainsi que des comparaisons portant sur la valeur de mana, la force, l'endurance, les dates, les prix et d'autres attributs. Les opérateurs de recherche comprennent les termes booléens, la négation, les expressions régulières pour certains champs et les parenthèses. Le site propose également des tags d'illustration gérés par les contributeurs et des recherches destinées aux utilisateurs telles que « Random Card » et « Tagger ». Scryfall consigne soigneusement les détails de Magic liés aux règles. Le service expose le texte Oracle actuel utilisé pour le fonctionnement des cartes, l'identité couleur, le coût de mana, la ligne de type, les mots-clés, toutes les parties des objets composés de plusieurs cartes et la légalité dans les formats. Ses données de décisions sont liées aux cartes individuelles et comprennent les dates de publication ainsi que les commentaires des décisions. Le service distingue les cartes recto-verso transformables, les cartes recto-verso modales, les cartes à face divisée, les cartes fusionnées, les jetons, les emblèmes et d'autres mises en page qui ne correspondent pas au modèle simple d'une carte à une seule face. Les développeurs peuvent utiliser l'API REST de Scryfall sans compte pour rechercher des cartes, utiliser la saisie semi-automatique et consulter les valeurs de catalogue, les extensions, les décisions, les symboles et les résultats de recherche. Les réponses de l'API comprennent, lorsqu'elles sont disponibles, les URI des images, les URI d'achat, les liens vers les cartes associées et les métadonnées de pagination. Scryfall publie également des fichiers de données volumineux téléchargeables, notamment les cartes par défaut, toutes les cartes, les cartes Oracle, les illustrations uniques et les décisions. Ces fichiers sont destinés au traitement hors ligne et sont mis à jour périodiquement ; le point d'accès aux données volumineuses indique leurs horodatages de mise à jour et leurs liens de téléchargement. La base de données couvre les cartes de Magic officiellement publiées ainsi que de nombreux objets de jeu associés. Les pages d'extensions affichent les dates de sortie, les codes d'extension, le nombre total de cartes, le statut numérique et l'iconographie. Elle est particulièrement utile pour suivre une même pièce de jeu à travers les réimpressions, les cartes promotionnelles, les sorties Secret Lair, les produits Commander, les extensions Masters et les sorties exclusivement numériques. La documentation de Scryfall demande aux utilisateurs de respecter les limites de débit, de mettre les résultats en cache et de fournir un agent utilisateur descriptif lors des requêtes à l'API. Elle précise également que les images des cartes et la propriété intellectuelle sous-jacente de Magic appartiennent à leurs propriétaires respectifs ; l'accès à ses données et à ses images ne confère aucun droit de propriété ni de réutilisation au-delà des conditions d'utilisation applicables.