Autenticación

Los tokens de API se crean y gestionan desde la barra lateral del servidor en el panel de TicketsX. Cada token está vinculado a un solo servidor, y el servidor necesita una suscripción Premium activa para crear o usar uno.

Crear un token

Activa Premium para el servidor desde la página Premium (la página de Acceso a la API enlaza directamente allí).
Abre la barra lateral del servidor y ve a Acceso a la API.
Ponle nombre al token (por ejemplo "Bot de soporte" o "Sincronización CRM").
Haz clic en Crear token y copia el valor que aparece.
Guárdalo en un gestor de secretos; no podrás volver a verlo una vez cierres el aviso.

Si Premium caduca

Tus tokens no se borran. Todas las peticiones a la API empiezan a devolver 402 con premium_required: true, y crear o renovar tokens queda bloqueado hasta que la suscripción vuelva a estar activa. Listar, desactivar y revocar sigue funcionando para que puedas ordenar igualmente. Trata el 402 en tu integración igual que el 401: deja de reintentar y avisa a una persona.

Respuesta cuando el servidor no tiene Premium

{
  "error": "The TicketsX REST API is a Premium feature. Activate Premium for this server to use API tokens.",
  "premium_required": true
}

Revocar un token lo invalida al momento en todos los endpoints. Crea antes un sustituto si no quieres interrupciones.

Usar un token

Envía el token como cabecera Bearer en cada petición. Todas las peticiones se limitan al servidor que creó el token.

Ejemplo de petición autenticada

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  https://api.ticketsx.xyz/<guild_id>/api/tickets