Dokumentacija

Perprask TicketsX greičiau

Nustatymo vadovai, visų komandų sąrašas, Premium galimybės ir REST API vienoje vietoje.

13.18

Įrašo paėmimas

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

Pagal bilieto numerį paima visą uždaryto bilieto pokalbio įrašą: visus duomenis (kas atvėrė, skydelis, vertinimas, uždarymo priežastis, perėmę žmonės, laikai), kiekvieną žinutę iš eilės ir žinučių statistiką pagal dalyvį. Bilietą pirmiausia raskite per **Paiešką įrašuose** arba parengtą archyvą paimkite per **Įrašo paėmimą HTML pavidalu**. Reikia teisės `view_transcripts` (numatytai išjungta).

Užklausos parametrai

PavadinimasTipasPrivalomaAprašas
limitnumber
neprivaloma
Žinučių skaičius puslapyje, 1-1000 (numatyta 500).
offsetnumber
neprivaloma
Kiek žinučių praleidžiama verčiant puslapius (numatyta 0).

Laukų messages ir participants turinys ateina iš įrašų rodyklės, kuri kuriama, kol serveris turi Premium, ir pirmą kartą jį įsigijus apima ir jūsų ligtolinį archyvą. Bilietas, uždarytas prieš įsigyjant (arba dar vykstant archyvo apdorojimui), grįžta su indexed: false ir tuščiu messages sąrašu. Tokioms naudokite Įrašo paėmimą HTML pavidalu arba lauką transcript.TranscriptUrl. Ilgus bilietus verskite objektu pagination.

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