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

Освой TicketsX быстрее

Инструкции по настройке, полный справочник команд, Premium-функции и REST API в одном месте.

13.20

Получить HTML стенограммы

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

Скачивает полную сохранённую HTML-стенограмму закрытого тикета. Это тот же архив, который показывает панель управления, со всеми сообщениями, встроенными сообщениями, ссылками на вложения и аватарами. Требует права `view_transcript_html` (по умолчанию отключено).

Параметры запроса

НазваниеТипОбязательноОписание
formatstring
необязательно
Укажи raw, чтобы получить сам HTML-файл с Content-Type: text/html — его сразу можно сохранить на диск или встроить в iframe. Без этого параметра придёт стандартная JSON-обёртка с метаданными стенограммы рядом с HTML. Ошибки всегда возвращаются в JSON.

Это самая чувствительная операция чтения в API, поэтому она ограничена 10 запросами в минуту на токен, и каждый вызов попадает в журнал действий твоего сервера. Стенограммы хранятся в зашифрованном виде и расшифровываются на каждый запрос. Очень большие архивы отклоняются с кодом 413, и в ответе будет transcript_url для просмотра.

Пример запроса: JSON-обёртка
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"
Пример запроса: сразу сохранить файл
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  -o ticket_42.html \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html?format=raw"
Пример ответа (стандартный JSON)
{
  "transcript": {
    "TicketId": 42,
    "PanelId": 1,
    "PanelName": "Support",
    "AuthorId": "123456789",
    "AuthorUsername": "jane",
    "Rating": 5,
    "RatingCount": 1,
    "CloseReason": "Resolved",
    "CreatedAt": 1732200000,
    "ClosedAt": 1732210000,
    "TranscriptUrl": "https://tickets.example.com/<guild_id>/transcripts/42"
  },
  "content_type": "text/html; charset=utf-8",
  "bytes": 184320,
  "html": "<!DOCTYPE html>..."
}