13
Referencia de la API
La API REST de TicketsX te permite conectar herramientas externas al sistema de tickets de tu servidor. Crea, cierra y gestiona tickets por programa sin pasar por la interfaz de Discord, busca en todo tu archivo de transcripciones y obtén el texto completo o el HTML de cualquier ticket cerrado.
La API REST es una función Premium. Los tokens de API solo se pueden crear y usar mientras el servidor tenga una suscripción Premium activa (mira la página de precios). Las peticiones de un servidor sin Premium se rechazan con 402 y un campo premium_required: true. Si Premium caduca, tus tokens se conservan pero dejan de funcionar hasta que reactives. Puedes seguir listándolos, desactivándolos y revocándolos desde el panel en cualquier momento.
https://api.ticketsx.xyzCada petición necesita un token de API enviado como token Bearer en la cabecera Authorization. Los tokens están limitados a un solo servidor y se pueden restringir por acción.
Authorization: Bearer <API_TOKEN>En todas las rutas de endpoint de abajo, sustituye <guild_id> por el ID de tu servidor de Discord y <ticket_id> por el ID del ticket correspondiente.
Content-Type: application/json es obligatorio en todos los cuerpos de petición POST. Las respuestas 4xx incluyen un campo JSON error. 401 significa que el token no es válido, ha caducado o se ha revocado. 402 significa que el servidor no tiene Premium (la respuesta lleva además premium_required: true). 403 significa que el token está desactivado o le falta el permiso necesario. 429 significa que se alcanzó un límite de uso (mira Límites de uso y seguridad) e incluye un valor retry_after en segundos.