Een transcriptie ophalen

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

Haalt via het ticketnummer de volledige transcriptie van een gesloten ticket op: alle gegevens (aanmaker, paneel, beoordeling, reden van sluiten, behandelaars, tijdstippen), elk bericht op volgorde van tijd en de cijfers per deelnemer. Zoek het ticket eerst met **Zoeken in transcripties**, of haal het opgemaakte archief op met **HTML van een transcriptie ophalen**. Vereist het recht `view_transcripts` (standaard uit).

Queryparameters

Naam	Type	Verplicht	Beschrijving
limit	number	optioneel	Berichten per pagina, 1 tot 1000 (standaard 500).
offset	number	optioneel	Hoeveel berichten je overslaat voor de paginering (standaard 0).

De inhoud van messages en participants komt uit de transcriptie-index, die wordt opgebouwd zolang je server Premium heeft en bij je eerste overstap ook over je bestaande archief wordt gelegd. Een ticket dat vóór de overstap sloot (of terwijl die inhaalslag nog loopt) komt terug met indexed: false en een lege array messages. Gebruik daarvoor HTML van een transcriptie ophalen of transcript.TranscriptUrl. Blader met het object pagination door lange tickets.

Voorbeeldverzoek

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>?limit=500"

Voorbeeldantwoord

{
  "transcript": {
    "TicketId": 42,
    "PanelId": 1,
    "PanelName": "Support",
    "AuthorId": "123456789",
    "AuthorUsername": "jane",
    "Rating": 5,
    "RatingCount": 1,
    "CloseReason": "Resolved",
    "CreatedAt": 1732200000,
    "ClosedAt": 1732210000,
    "ClosedBy": "987654321",
    "ClaimedIds": ["987654321"],
    "TranscriptUrl": "https://tickets.example.com/<guild_id>/transcripts/42"
  },
  "indexed": true,
  "messages": [
    { "MessageId": "111", "AuthorId": "123456789", "AuthorUsername": "jane", "IsBot": false, "Content": "My login is broken", "CreatedAt": 1732200050 },
    { "MessageId": "112", "AuthorId": "987654321", "AuthorUsername": "staff", "IsBot": false, "Content": "Looking into it now!", "CreatedAt": 1732200110 }
  ],
  "participants": [
    { "UserId": "123456789", "Username": "jane", "IsBot": false, "MessageCount": 12, "FirstMessageAt": 1732200050, "LastMessageAt": 1732209900 }
  ],
  "pagination": { "total": 2, "limit": 500, "offset": 0, "returned": 2 }
}