13.18
Hent en udskrift
/<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
| Navn | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| limit | number | valgfrit | Beskeder pr. side, 1 til 1000 (standard 500). |
| offset | number | 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.
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 }
}