13.20
Pobranie zapisu w HTML
GET
/<guild_id>/api/transcripts/<ticket_id>/htmlPobiera 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
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| format | string | 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>..."
}