Dokumentacja

Poznaj TicketsX szybciej

Poradniki konfiguracji, pełny spis komend, funkcje Premium i API REST w jednym miejscu.

13.20

Pobranie zapisu w HTML

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

Pobiera pełny przechowywany zapis HTML zamkniętego zgłoszenia. To dokładnie to archiwum, które wyświetla panel, ze wszystkimi wiadomościami, osadzonymi wiadomościami, odnośnikami do załączników i awatarami. Wymaga uprawnienia `view_transcript_html` (domyślnie wyłączonego).

Parametry zapytania

NazwaTypWymaganeOpis
formatstring
opcjonalne
Ustaw raw, aby dostać sam plik HTML z nagłówkiem Content-Type: text/html, gotowy do zapisania na dysku albo osadzenia w ramce. Pomiń, aby dostać domyślną kopertę JSON z metadanymi zapisu obok kodu HTML. Błędy zawsze wracają w formacie JSON.

To najbardziej wrażliwy odczyt w całym API, więc ma limit 10 zapytań na minutę dla każdego tokenu, a każde wywołanie trafia do dziennika działań serwera. Zapisy przechowujemy w postaci zaszyfrowanej i odszyfrowujemy przy każdym żądaniu. Bardzo duże archiwa są odrzucane z kodem 413, a odpowiedź zawiera wtedy pole transcript_url do podglądu.

Przykładowe żądanie: koperta JSON
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"
Przykładowe żądanie: zapis pliku wprost na dysk
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"
Przykładowa odpowiedź (domyślny 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>..."
}