Dokumentasjon

Lær TicketsX raskere

Veiledninger, alle kommandoer, Premium-funksjoner og REST-API-et på ett sted.

13.18

Hente en utskrift

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

Henter hele utskriften av en lukket sak ut fra nummeret på saken: alle opplysninger (hvem som opprettet den, panel, vurdering, begrunnelse for lukking, hvem som har tatt den, tidspunkter), hver melding i tidsrekkefølge og tall for hver deltaker. Finn saken først med **Søke i utskrifter**, eller hent det ferdige arkivet med **Hente utskrift som HTML**. Krever rettigheten `view_transcripts` (av som standard).

Spørringsparametere

NavnTypePåkrevdBeskrivelse
limitnumber
valgfritt
Meldinger per side, 1 til 1000 (standard 500).
offsetnumber
valgfritt
Antall meldinger som blir hoppet over ved sideinndeling (standard 0).

Innholdet i messages og participants kommer fra utskriftsindeksen, som blir bygd mens serveren har Premium, og lagt over det gamle arkivet ditt første gang du oppgraderer. En sak som ble lukket før oppgraderingen (eller mens indekseringen av de gamle sakene fortsatt går), kommer tilbake med indexed: false og en tom messages-liste. Til dem bruker du Hente utskrift som HTML eller transcript.TranscriptUrl. Bla gjennom lange saker med objektet pagination.

Eksempel på kall
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 }
}