13
Referência da API
A API REST do TicketsX permite conectar ferramentas externas ao sistema de tickets do seu servidor. Crie, feche e gerencie tickets por programação sem passar pela interface do Discord, pesquise em todo o seu arquivo de transcrições e obtenha o texto completo ou o HTML de qualquer ticket fechado.
A API REST é um recurso Premium. Tokens de API só podem ser criados e usados enquanto o servidor tiver uma assinatura Premium ativa (veja a página de preços). Requisições de servidores sem Premium são recusadas com 402 e um campo premium_required: true. Se o Premium vencer, seus tokens são mantidos mas param de funcionar até você reativar. Você ainda pode listá-los, desativá-los e revogá-los pelo painel a qualquer momento.
https://api.ticketsx.xyzToda requisição exige um token de API enviado como token Bearer no cabeçalho Authorization. Os tokens valem para um único servidor e podem ser restringidos por ação.
Authorization: Bearer <API_TOKEN>Em todos os caminhos de endpoint abaixo, troque <guild_id> pelo ID do seu servidor do Discord e <ticket_id> pelo ID do ticket em questão.
Content-Type: application/json é obrigatório em todos os corpos de requisição POST. Respostas 4xx trazem um campo JSON error. 401 significa que o token é inválido, venceu ou foi revogado. 402 significa que o servidor não tem Premium (a resposta também traz premium_required: true). 403 significa que o token está desativado ou não tem a permissão necessária. 429 significa que um limite de uso foi atingido (veja Limites de uso e segurança) e inclui um valor retry_after em segundos.