API de envio de deck: mande uma decklist para o Reliquary via REST
O Reliquary tem uma API de envio de deck num sentido: um programa pode mandar uma decklist como texto e receber um deck de volta, com cada linha que não foi lida indicada. Ela não inscreve um deck num torneio, num organizador ou num cliente online; para um evento presencial, a folha de registro grátis transforma uma lista num PDF para entregar.
As chamadas
Cada ferramenta do servidor MCP também é uma chamada REST, POST /api/v1/tools/<name> com os argumentos da ferramenta em JSON, e GET /api/v1/tools lista todas com suas descrições.
| Chamada | O que faz |
|---|---|
POST /api/v1/tools/import_deck | Cria um deck a partir de decklist_text; devolve as cartas adicionadas, os nomes que não conseguiu resolver e as linhas que ignorou |
POST /api/v1/decks | Cria um deck vazio, com seu formato e comandante |
POST /api/v1/decks/{id}/wants | Adiciona até 75 linhas à lista de um deck numa chamada, cada uma com sua quantidade |
POST /api/v1/decks/{id}/claim | Reserva para o deck as cópias que você tem, e diz quais são compartilhadas e quais estão faltando |
GET /api/v1/export/deck/{id} | O deck como texto simples de decklist |
O texto da decklist são linhas simples: 4 Lightning Bolt (2XM) 123, títulos Commander e Sideboard, linhas SB:. O guia de decklist lista todas as formas que ele lê.
Como entrar
Uma requisição leva um bearer token OAuth, o mesmo login que um assistente usa. O servidor registra clientes em /oauth/register, e você permite o acesso na página de consentimento do próprio Reliquary. Desconectar o cliente na página da sua conta encerra o token dele na próxima chamada.
O que ela não faz
- Inscrever uma lista num evento, numa plataforma de torneios ou num cliente de jogo.
- Excluir sem perguntar:
delete_decksó descreve o que faria até ser chamada de novo comconfirm: true, e excluir um deck nunca exclui cartas. - Esconder uma cópia compartilhada: uma reserva compartilhada indica os outros decks e o lugar onde a carta está fisicamente.
Perguntas
A API está no plano grátis?
Sim. Uma conta grátis tem cinco decks: um sexto responde PLAN_LIMIT, status 402, com um link para os preços. Chamadas à API nunca são vendidas.
Ela lê um link do Moxfield em vez de texto?
import_deck também aceita um link público de deck do Moxfield, mas essa busca pode falhar. Texto sempre funciona.
O que devo entregar num evento?
O que o organizador pedir. A folha de registro cria um PDF para imprimir com uma lista, o deck principal e o sideboard contados; ela não é o formulário oficial de nenhum organizador.