API für Decklisten: eine Deckliste per REST an Reliquary senden
Reliquary hat eine API für Decklisten in einem bestimmten Sinn: Ein Programm kann ihr eine Deckliste als Text schicken und bekommt ein Deck zurück, mit jeder Zeile benannt, die es nicht lesen konnte. Sie meldet kein Deck bei einem Turnier, einem Veranstalter oder einem Online-Client an; für ein Papier-Event macht der kostenlose Registrierungsbogen aus einer Liste ein PDF zum Abgeben.
Die Aufrufe
Jedes Werkzeug des MCP-Servers ist auch ein REST-Aufruf, POST /api/v1/tools/<name> mit den Argumenten des Werkzeugs als JSON, und GET /api/v1/tools listet sie mit ihren Beschreibungen.
| Aufruf | Was er tut |
|---|---|
POST /api/v1/tools/import_deck | Macht ein Deck aus decklist_text; gibt die hinzugefügten Karten zurück, die Namen, die es nicht auflösen konnte, und die Zeilen, die es übergangen hat |
POST /api/v1/decks | Macht ein leeres Deck, mit Format und Commander |
POST /api/v1/decks/{id}/wants | Fügt der Liste eines Decks bis zu 75 Zeilen in einem Aufruf hinzu, jede mit ihrer Anzahl |
POST /api/v1/decks/{id}/claim | Reserviert die Exemplare, die du besitzt, für das Deck und sagt, welche geteilt sind und welche fehlen |
GET /api/v1/export/deck/{id} | Das Deck als einfacher Decklisten-Text |
Der Decklisten-Text besteht aus einfachen Zeilen: 4 Lightning Bolt (2XM) 123, Überschriften Commander und Sideboard, Zeilen mit SB:. Die Anleitung zu Decklisten listet jede Form, die gelesen wird.
Anmelden
Eine Anfrage trägt ein OAuth-Bearer-Token, dieselbe Anmeldung, die ein Assistent nutzt. Der Server registriert Clients unter /oauth/register, und du erlaubst den Zugriff auf der eigenen Zustimmungsseite von Reliquary. Trennst du den Client auf deiner Kontoseite, endet sein Token beim nächsten Aufruf.
Was sie nicht tut
- Eine Liste bei einem Event, einer Turnierplattform oder einem Spiel-Client anmelden.
- Ohne Rückfrage löschen:
delete_deckbeschreibt nur, was es tun würde, bis es erneut mitconfirm: trueaufgerufen wird, und ein Deck zu löschen löscht nie Karten. - Ein geteiltes Exemplar verbergen: Eine geteilte Reservierung nennt die anderen Decks und den Ort, an dem die Karte physisch liegt.
Fragen
Ist die API im kostenlosen Plan enthalten?
Ja. Ein kostenloses Konto hat fünf Decks: Ein sechstes antwortet mit PLAN_LIMIT, Status 402, mit einem Link zu den Preisen. API-Aufrufe werden nie verkauft.
Kann sie statt Text einen Moxfield-Link lesen?
import_deck nimmt auch einen öffentlichen Moxfield-Deck-Link, aber dieser Abruf kann scheitern. Text funktioniert immer.
Was gebe ich bei einem Event ab?
Was der Veranstalter verlangt. Der Registrierungsbogen macht aus einer Liste ein druckbares PDF mit gezähltem Hauptdeck und Sideboard; er ist nicht das offizielle Formular eines Veranstalters.