Documentație

Învață TicketsX mai repede

Ghiduri de configurare, lista completă de comenzi, funcțiile Premium și API-ul REST într-un singur loc.

13.18

Aducerea unei transcrieri

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

Aduce, după numărul tichetului, toată transcrierea unui tichet închis: datele complete (cine l-a deschis, panoul, evaluarea, motivul închiderii, cine l-a preluat, momentele importante), fiecare mesaj în ordine și statisticile pe fiecare participant. Găsește întâi tichetul cu **Căutarea în transcrieri** sau ia arhiva gata făcută cu **Aducerea transcrierii în HTML**. Cere permisiunea `view_transcripts` (oprită din start).

Parametri de interogare

NumeTipObligatoriuDescriere
limitnumber
opțional
Mesaje pe pagină, 1-1000 (implicit 500).
offsetnumber
opțional
Numărul de mesaje sărite pentru paginare (implicit 0).

Conținutul din messages și participants vine din indexul de transcrieri, care se construiește cât timp serverul are Premium și se completează peste arhiva ta veche la prima trecere la Premium. Un tichet închis înainte de trecere (sau în timp ce completarea indexului încă rulează) se întoarce cu indexed: false și cu o listă messages goală. Pentru ele folosește Aducerea transcrierii în HTML sau transcript.TranscriptUrl. Parcurge tichetele lungi cu obiectul pagination.

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