Dokumentation

Lær TicketsX hurtigere

Guider, alle kommandoer, Premium-funktioner og REST-API'et ét sted.

13.20

Hent udskrift som HTML

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

Henter hele den gemte HTML-udskrift for en lukket sag. Det er præcis det arkiv, kontrolpanelet viser, med alle beskeder, indlejrede beskeder, links til vedhæftede filer og profilbilleder. Kræver rettigheden `view_transcript_html` (slået fra som standard).

Forespørgselsparametre

NavnTypePåkrævetBeskrivelse
formatstring
valgfrit
Sæt den til raw for at få selve HTML-filen med Content-Type: text/html, klar til at gemme eller lægge i en iframe. Udelad den for det almindelige JSON-svar med oplysningerne om udskriften ved siden af HTML'en. Fejl kommer altid tilbage som JSON.

Det er den mest følsomme læsning i API'et, så den er begrænset til 10 kald i minuttet pr. nøgle, og hvert kald bliver skrevet i serverens aktivitetslog. Udskrifterne ligger krypteret og bliver låst op ved hvert kald. Meget store arkiver bliver afvist med 413, og svaret indeholder så transcript_url, du kan se dem med i stedet.

Eksempel på kald: JSON-svar
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"
Eksempel på kald: gem filen direkte
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"
Eksempel på svar (almindelig 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>..."
}