API na odoslanie decku: pošli decklist do Reliquary cez REST
Reliquary má API na odoslanie decku v jednom zmysle: program mu môže poslať decklist ako text a dostane späť deck, v ktorom je pomenovaný každý riadok, ktorý sa nedal prečítať. Deck neodosiela na turnaj, organizátorovi ani do online klienta; na papierové podujatie premení bezplatný registračný hárok zoznam na PDF na odovzdanie.
Volania
Každý nástroj MCP servera je aj REST volanie, POST /api/v1/tools/<name> s argumentmi nástroja ako JSON, a GET /api/v1/tools ich vypíše aj s popismi.
| Volanie | Čo robí |
|---|---|
POST /api/v1/tools/import_deck | Vytvorí deck z decklist_text; vráti pridané karty, názvy, ktoré nevedel priradiť, a riadky, ktoré ignoroval |
POST /api/v1/decks | Vytvorí prázdny deck s jeho formátom a commanderom |
POST /api/v1/decks/{id}/wants | Pridá do zoznamu decku až 75 riadkov naraz, každý s jeho počtom |
POST /api/v1/decks/{id}/claim | Vyhradí pre deck kópie, ktoré vlastníš, a povie, ktoré sú zdieľané a ktoré chýbajú |
GET /api/v1/export/deck/{id} | Deck ako čistý text decklistu |
Text decklistu sú obyčajné riadky: 4 Lightning Bolt (2XM) 123, nadpisy Commander a Sideboard, riadky SB:. Návod k decklistu vypisuje každý tvar, ktorý číta.
Prihlásenie
Požiadavka nesie OAuth bearer token, rovnaké prihlásenie, aké používa asistent. Server registruje klientov na /oauth/register a prístup povolíš na vlastnej stránke súhlasu Reliquary. Odpojenie klienta na stránke tvojho účtu ukončí jeho token pri nasledujúcom volaní.
Čo neurobí
- Neodošle zoznam na podujatie, turnajovú platformu ani do herného klienta.
- Nezmaže nič bez opýtania:
delete_decklen popíše, čo by urobil, kým ho nezavoláš znova sconfirm: true, a zmazanie decku nikdy nezmaže karty. - Neskryje zdieľanú kópiu: zdieľané vyhradenie pomenuje ostatné decky a to, kde karta fyzicky je.
Otázky
Je API v bezplatnom pláne?
Áno. Bezplatný účet pojme päť deckov: šiesty odpovie PLAN_LIMIT, stavový kód 402, s odkazom na cenník. Volania API sa nikdy nepredávajú.
Vie namiesto textu prečítať odkaz z Moxfieldu?
import_deck berie aj verejný odkaz na deck z Moxfieldu, ale jeho stiahnutie môže zlyhať. Text funguje vždy.
Čo mám odovzdať na podujatí?
To, čo žiada organizátor. Registračný hárok vytvorí PDF zoznamu na tlač so spočítaným hlavným deckom a sideboardom; nie je to oficiálny formulár žiadneho organizátora.