HTML van een transcriptie ophalen

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

Downloadt de volledige opgeslagen HTML-transcriptie van een gesloten ticket. Dit is precies het archief dat het dashboard laat zien, met alle berichten, embeds, links naar bijlagen en avatars. Vereist het recht `view_transcript_html` (standaard uit).

Queryparameters

Naam	Type	Verplicht	Beschrijving
format	string	optioneel	Zet hem op `raw` om het HTML-bestand zelf te krijgen met `Content-Type: text/html`, klaar om op te slaan of in een iframe te zetten. Laat hem weg voor de standaard JSON-verpakking met de gegevens van de transcriptie naast de HTML. Fouten komen altijd als JSON terug.

Dit is de gevoeligste leesactie van de API, dus hij is beperkt tot 10 verzoeken per minuut per token en elke aanroep komt in het activiteitenlog van je server te staan. Transcripties staan versleuteld opgeslagen en worden per verzoek ontsleuteld. Heel grote archieven worden geweigerd met 413, en het antwoord bevat dan de transcript_url om hem toch te bekijken.

Voorbeeldverzoek: JSON-verpakking

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

Voorbeeldverzoek: het bestand meteen opslaan

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"

Voorbeeldantwoord (standaard 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>..."
}