Dokumentace

Nauč se TicketsX rychleji

Návody k nastavení, přehled všech příkazů, funkce Premium a REST API na jednom místě.

13.20

Načtení přepisu v HTML

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

Stáhne celý uložený přepis zavřeného tiketu v HTML. Je to přesně ten archiv, který zobrazuje nástěnka, se všemi zprávami, vloženými zprávami, odkazy na přílohy a avatary. Vyžaduje oprávnění `view_transcript_html` (ve výchozím stavu vypnuté).

Parametry dotazu

NázevTypPovinnéPopis
formatstring
volitelné
Nastavte raw, ať dostanete samotný soubor HTML s hlavičkou Content-Type: text/html, připravený k uložení na disk nebo vložení do rámu. Bez tohoto parametru dostanete výchozí obálku JSON s metadaty přepisu vedle HTML. Chyby se vracejí vždy v JSON.

Je to nejcitlivější čtení, které API nabízí, proto má limit 10 požadavků za minutu na token a každé volání se zapíše do záznamu činnosti vašeho serveru. Přepisy jsou uložené zašifrovaně a při každém požadavku se dešifrují. Hodně velké archivy se odmítnou s kódem 413 a odpověď místo nich obsahuje transcript_url k nahlédnutí.

Příklad požadavku: obálka JSON
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"
Příklad požadavku: uložení souboru rovnou na disk
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"
Příklad odpovědi (výchozí 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>..."
}