Dokumentation

Lär dig TicketsX snabbare

Guider, alla kommandon, Premium-funktioner och REST-API:et på ett ställe.

13.18

Hämta en utskrift

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

Hämtar hela utskriften för ett stängt ärende utifrån ärendenumret: alla uppgifter (vem som öppnade, panel, omdöme, anledning till stängning, vilka som tagit ärendet, tidpunkter), varje meddelande i tidsordning och statistik per deltagare. Hitta ärendet först med **Söka i utskrifter**, eller hämta det färdiga arkivet med **Hämta utskrift som HTML**. Kräver behörigheten `view_transcripts` (av som standard).

Frågeparametrar

NamnTypObligatoriskBeskrivning
limitnumber
valfritt
Meddelanden per sida, 1 till 1000 (standard 500).
offsetnumber
valfritt
Antal meddelanden som hoppas över vid sidindelning (standard 0).

Innehållet i messages och participants kommer från utskriftsindexet, som byggs medan servern har Premium och fylls på över ditt befintliga arkiv vid din första uppgradering. Ett ärende som stängdes före uppgraderingen (eller medan påfyllningen fortfarande pågår) kommer tillbaka med indexed: false och en tom messages-lista. För dem använder du Hämta utskrift som HTML eller transcript.TranscriptUrl. Bläddra genom långa ärenden med objektet pagination.

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