13.18
Hente en utskrift
/<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
| Navn | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| limit | number | valgfritt | Meldinger per side, 1 til 1000 (standard 500). |
| offset | number | 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.
curl -X GET \
-H "Authorization: Bearer <API_TOKEN>" \
"https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>?limit=500"{
"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 }
}