Документація

Опануй TicketsX швидше

Посібники з налаштування, повний перелік команд, можливості Premium і REST API в одному місці.

13.18

Отримання запису

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

Отримує за номером тікета весь запис закритого тікета: усі відомості (хто відкрив, панель, оцінка, причина закриття, хто взяв у роботу, час), кожне повідомлення за порядком і статистику повідомлень для кожного учасника. Спершу знайдіть тікет через **Пошук у записах** або заберіть готовий архів через **Отримання запису в HTML**. Потребує права `view_transcripts` (типово вимкнено).

Параметри запиту

НазваТипОбов'язковоОпис
limitnumber
необовʼязково
Повідомлень на сторінку, 1-1000 (типово 500).
offsetnumber
необовʼязково
Скільки повідомлень пропускається під час гортання (типово 0).

Вміст полів messages і participants походить із покажчика записів, який будується, доки сервер має Premium, і під час першого підключення охоплює й ваш попередній архів. Тікет, закритий до підключення (або доки опрацювання архіву ще триває), повертається з indexed: false і порожнім списком messages. Для таких користуйтеся Отриманням запису в HTML або полем transcript.TranscriptUrl. Довгі тікети гортайте об'єктом 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 }
}