Transkript-HTML abrufen

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

Lädt das vollständig gespeicherte HTML-Transkript eines geschlossenen Tickets herunter. Das ist genau das Archiv, das auch im Dashboard angezeigt wird, mit jeder Nachricht, jedem Embed, jedem Anhanglink und jedem Profilbild. Erfordert die Berechtigung `view_transcript_html` (standardmäßig aus).

Abfrageparameter

Name	Typ	Pflichtfeld	Beschreibung
format	string	optional	Setze den Wert auf `raw`, um die HTML-Datei selbst mit `Content-Type: text/html` zu erhalten, fertig zum Speichern oder zum Einbetten in einen iframe. Ohne Angabe kommt der Standard-JSON-Umschlag mit den Metadaten des Transkripts neben dem HTML. Fehler werden immer als JSON zurückgegeben.

Das ist die sensibelste Leseabfrage der API, deshalb ist sie auf 10 Anfragen pro Minute und Token begrenzt, und jeder Aufruf landet im Aktivitätsprotokoll deines Servers. Transkripte werden verschlüsselt gespeichert und pro Anfrage entschlüsselt. Sehr große Archive werden mit 413 abgelehnt, die Antwort enthält dann die transcript_url zum Ansehen.

Beispielanfrage: JSON-Umschlag

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

Beispielanfrage: Datei direkt speichern

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"

Beispielantwort (Standard-JSON)

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