Documentación

Aprende TicketsX más rápido

Guías de instalación, la referencia completa de comandos, las funciones Premium y la API REST en un solo sitio.

13.20

Obtener el HTML de una transcripción

GET/<guild_id>/api/transcripts/<ticket_id>/html

Descarga la transcripción HTML completa guardada de un ticket cerrado. Es exactamente el archivo que muestra el panel, con cada mensaje, embed, enlace de adjunto y avatar. Requiere el permiso `view_transcript_html` (desactivado por defecto).

Parámetros de consulta

NombreTipoObligatorioDescripción
formatstring
opcional
Ponlo en raw para recibir el propio archivo HTML con Content-Type: text/html, listo para guardarlo en disco o meterlo en un iframe. Omítelo para obtener el envoltorio JSON por defecto, con los metadatos de la transcripción junto al HTML. Los errores siempre se devuelven en JSON.

Es la lectura más sensible que ofrece la API, así que está limitada a 10 peticiones por minuto y token, y cada llamada queda anotada en el registro de actividad de tu servidor. Las transcripciones se guardan cifradas y se descifran en cada petición. Los archivos muy grandes se rechazan con 413 y la respuesta incluye la transcript_url para verlo ahí.

Ejemplo de petición: envoltorio JSON
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"
Ejemplo de petición: guardar el archivo directamente
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  -o ticket_42.html \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html?format=raw"
Ejemplo de respuesta (JSON por defecto)
{
  "transcript": {
    "TicketId": 42,
    "PanelId": 1,
    "PanelName": "Support",
    "AuthorId": "123456789",
    "AuthorUsername": "jane",
    "Rating": 5,
    "RatingCount": 1,
    "CloseReason": "Resolved",
    "CreatedAt": 1732200000,
    "ClosedAt": 1732210000,
    "TranscriptUrl": "https://tickets.example.com/<guild_id>/transcripts/42"
  },
  "content_type": "text/html; charset=utf-8",
  "bytes": 184320,
  "html": "<!DOCTYPE html>..."
}