Dokumentáció

Tanuld meg gyorsabban a TicketsX-et

Beállítási útmutatók, a teljes parancslista, a Premium funkciói és a REST API egy helyen.

13.20

Átirat lekérése HTML-ben

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

Letölti egy lezárt jegy teljes tárolt HTML-átiratát. Pontosan az az archívum, amelyet a vezérlőpult megjelenít, minden üzenettel, beágyazott üzenettel, csatolmányhivatkozással és profilképpel. `view_transcript_html` jogosultságot igényel (alapból kikapcsolva).

Lekérdezési paraméterek

NévTípusKötelezőLeírás
formatstring
nem kötelező
Állítsd raw értékre, ha magát a HTML-fájlt kéred Content-Type: text/html fejléccel, lemezre mentésre vagy iframe-be illesztésre készen. Hagyd el, ha az alapértelmezett JSON-burkot kéred, amelyben az átirat adatai a HTML mellett szerepelnek. A hibák mindig JSON formában érkeznek.

Ez az API legérzékenyebb lekérdezése, ezért kulcsonként percenként 10 kérésre van korlátozva, és minden hívás bekerül a szervered tevékenységnaplójába. Az átiratokat titkosítva tároljuk, és minden kérésnél visszafejtjük. A nagyon nagy archívumokat 413 válasszal utasítjuk el, és a válasz ilyenkor tartalmazza a transcript_url mezőt, amelyen megnézheted.

Példa kérés: JSON-burok
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"
Példa kérés: a fájl közvetlen mentése
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élda válasz (alapértelmezett 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>..."
}