Ottenere l'HTML di una trascrizione

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

Scarica la trascrizione HTML completa e archiviata di un ticket chiuso. È esattamente l'archivio che mostra la dashboard, con tutti i messaggi, gli embed, i link agli allegati e gli avatar. Richiede il permesso `view_transcript_html` (disattivato per impostazione predefinita).

Parametri della query

Nome	Tipo	Obbligatorio	Descrizione
format	string	facoltativo	Imposta `raw` per ricevere il file HTML vero e proprio con `Content-Type: text/html`, pronto da salvare su disco o da mettere in un iframe. Se lo ometti ricevi la busta JSON predefinita, con i metadati della trascrizione accanto all'HTML. Gli errori tornano sempre in JSON.

È la lettura più delicata offerta dall'API, quindi è limitata a 10 richieste al minuto per token e ogni chiamata finisce nel registro attività del tuo server. Le trascrizioni sono conservate cifrate e vengono decifrate a ogni richiesta. Gli archivi troppo grandi vengono rifiutati con 413 e la risposta include il transcript_url da usare per consultarli.

Esempio di richiesta: busta JSON

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

Esempio di richiesta: salvare il file direttamente

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"

Esempio di risposta (JSON predefinito)

{
  "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>..."
}