13.20
Obtener el HTML de una transcripción
GET
/<guild_id>/api/transcripts/<ticket_id>/htmlDescarga 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
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| format | string | 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>..."
}