13.20
Tallenteen HTML:n hakeminen
GET
/<guild_id>/api/transcripts/<ticket_id>/htmlLataa suljetun tiketin koko säilytetyn HTML-tallenteen. Se on täsmälleen se arkisto, jonka hallintapaneeli näyttää, ja siinä ovat kaikki viestit, upotetut viestit, liitelinkit ja profiilikuvat. Vaatii oikeuden `view_transcript_html` (oletuksena pois päältä).
Kyselyparametrit
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| format | string | valinnainen | Aseta arvoksi raw, niin saat itse HTML-tiedoston otsakkeella Content-Type: text/html valmiina tallennettavaksi tai upotettavaksi kehykseen. Jos jätät sen pois, saat oletusmuotoisen JSON-vastauksen, jossa tallenteen tiedot ovat HTML:n rinnalla. Virheet palautuvat aina JSON-muodossa. |
Tämä on rajapinnan arkaluontoisin lukutoiminto, joten se on rajattu 10 pyyntöön minuutissa avainta kohden, ja jokainen kutsu kirjataan palvelimesi toimintalokiin. Tallenteet säilytetään salattuina ja puretaan jokaisella pyynnöllä. Hyvin suuret arkistot hylätään vastauksella 413, ja vastauksessa on silloin transcript_url, jolla ne voi katsoa.
Esimerkkipyyntö: JSON-vastaus
curl -X GET \
-H "Authorization: Bearer <API_TOKEN>" \
"https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"Esimerkkipyyntö: tiedoston tallennus suoraan
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"Esimerkkivastaus (oletusmuotoinen 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>..."
}