Dokumentation

Lær TicketsX hurtigere

Guider, alle kommandoer, Premium-funktioner og REST-API'et ét sted.

13.18

Hent en udskrift

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

Henter hele udskriften for en lukket sag ud fra sagens nummer: alle oplysninger (hvem der oprettede den, panel, bedømmelse, begrundelse for lukning, hvem der har overtaget den, tidspunkter), hver besked i tidsrækkefølge og tal for hver deltager. Find sagen først med **Søg i udskrifter**, eller hent det færdige arkiv med **Hent udskrift som HTML**. Kræver rettigheden `view_transcripts` (slået fra som standard).

Forespørgselsparametre

NavnTypePåkrævetBeskrivelse
limitnumber
valgfrit
Beskeder pr. side, 1 til 1000 (standard 500).
offsetnumber
valgfrit
Antal beskeder, der springes over ved sideinddeling (standard 0).

Indholdet i messages og participants kommer fra udskriftsindekset, som bliver bygget, mens serveren har Premium, og lagt hen over dit hidtidige arkiv, første gang du opgraderer. En sag, der blev lukket før opgraderingen (eller mens indekseringen af de gamle sager stadig kører), kommer tilbage med indexed: false og en tom messages-liste. Til dem bruger du Hent udskrift som HTML eller transcript.TranscriptUrl. Bladr gennem lange sager med objektet pagination.

Eksempel på kald
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>?limit=500"
Eksempel på svar
{
  "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 }
}