Lấy bản ghi dạng HTML

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

Tải về trọn bản ghi HTML đang lưu của một ticket đã đóng. Đây đúng là kho lưu mà bảng điều khiển hiển thị, với đủ mọi tin nhắn, tin nhắn nhúng, liên kết tệp đính kèm và ảnh đại diện. Cần quyền `view_transcript_html` (mặc định tắt).

Tham số truy vấn

Tên	Kiểu	Bắt buộc	Mô tả
format	string	tùy chọn	Đặt `raw` để nhận thẳng tệp HTML với `Content-Type: text/html`, sẵn sàng ghi ra đĩa hay nhúng vào iframe. Bỏ trống thì nhận phản hồi JSON mặc định, có dữ liệu mô tả bản ghi nằm cạnh mã HTML. Lỗi thì lúc nào cũng trả về dạng JSON.

Đây là phép đọc nhạy cảm nhất mà API cung cấp, nên bị giới hạn 10 yêu cầu mỗi phút cho mỗi khóa và mỗi lần gọi đều được ghi vào nhật ký hoạt động của máy chủ bạn. Bản ghi được lưu ở dạng mã hóa và giải mã theo từng yêu cầu. Kho lưu quá lớn sẽ bị từ chối với mã 413, khi đó phản hồi có kèm transcript_url để bạn xem thay thế.

Ví dụ về yêu cầu: phản hồi JSON

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"

Ví dụ về yêu cầu: lưu thẳng tệp về máy

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"

Ví dụ về phản hồi (JSON mặc định)

{
  "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>..."
}