API d’envoi de decklist : envoie une decklist à Reliquary par REST
Reliquary a une API d’envoi de decklist dans un sens précis : un programme peut lui envoyer une decklist en texte et recevoir un deck en retour, avec chaque ligne qu’il n’a pas pu lire nommée. Elle n’inscrit pas un deck à un tournoi, auprès d’un organisateur ou dans un client en ligne ; pour un tournoi en papier, la feuille de decklist gratuite transforme une liste en PDF à rendre.
Les appels
Chaque outil du serveur MCP est aussi un appel REST, POST /api/v1/tools/<name> avec les arguments de l’outil en JSON, et GET /api/v1/tools les liste avec leurs descriptions.
| Appel | Ce qu’il fait |
|---|---|
POST /api/v1/tools/import_deck | Fait un deck à partir de decklist_text ; renvoie les cartes ajoutées, les noms qu’il n’a pas pu résoudre et les lignes qu’il a ignorées |
POST /api/v1/decks | Fait un deck vide, avec son format et son commandant |
POST /api/v1/decks/{id}/wants | Ajoute jusqu’à 75 lignes à la liste d’un deck en un appel, chacune avec sa quantité |
POST /api/v1/decks/{id}/claim | Attribue au deck les exemplaires que tu possèdes, et dit lesquels sont partagés et lesquels manquent |
GET /api/v1/export/deck/{id} | Le deck en texte de decklist brut |
Le texte de la decklist, ce sont des lignes simples : 4 Lightning Bolt (2XM) 123, les intitulés Commander et Sideboard, les lignes SB:. Le guide des decklists liste toutes les formes qu’il lit.
Se connecter
Une requête porte un jeton OAuth bearer, la même connexion qu’utilise un assistant. Le serveur enregistre les clients sur /oauth/register, et tu autorises l’accès sur la page de consentement de Reliquary. Déconnecter le client sur la page de ton compte met fin à son jeton dès l’appel suivant.
Ce qu’elle ne fera pas
- Inscrire une liste à un tournoi, sur une plateforme de tournoi ou dans un client de jeu.
- Supprimer sans demander :
delete_deckdécrit seulement ce qu’il ferait, jusqu’à être rappelé avecconfirm: true, et supprimer un deck ne supprime jamais de cartes. - Cacher un exemplaire partagé : une attribution partagée nomme les autres decks et l’endroit où la carte se trouve physiquement.
Questions
L’API est-elle dans la formule gratuite ?
Oui. Un compte gratuit contient cinq decks : un sixième répond PLAN_LIMIT, statut 402, avec un lien vers les tarifs. Les appels d’API ne sont jamais vendus.
Peut-elle lire un lien Moxfield au lieu du texte ?
import_deck prend aussi le lien public d’un deck Moxfield, mais cette récupération peut échouer. Le texte marche toujours.
Que dois-je rendre lors d’un tournoi ?
Ce que demande l’organisateur. La feuille de decklist fait un PDF imprimable d’une liste, avec son deck principal et sa réserve comptés ; ce n’est le formulaire officiel d’aucun organisateur.