Tài liệu

Nắm TicketsX nhanh hơn

Hướng dẫn thiết lập, toàn bộ danh sách lệnh, tính năng Premium và REST API, gom về một chỗ.

13.18

Lấy một bản ghi

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

Lấy theo số ticket toàn bộ bản ghi của một ticket đã đóng: đầy đủ dữ liệu mô tả (người mở, bảng, đánh giá, lý do đóng, những người đã nhận, các mốc thời gian), mọi tin nhắn theo thứ tự thời gian và số liệu tin nhắn cho từng người tham gia. Hãy tìm ticket trước bằng **Tìm trong bản ghi**, hoặc lấy kho lưu đã dựng sẵn bằng **Lấy bản ghi dạng HTML**. Cần quyền `view_transcripts` (mặc định tắt).

Tham số truy vấn

TênKiểuBắt buộcMô tả
limitnumber
tùy chọn
Số tin nhắn mỗi trang, 1-1000 (mặc định 500).
offsetnumber
tùy chọn
Số tin nhắn bỏ qua khi phân trang (mặc định 0).

Nội dung của messagesparticipants lấy từ chỉ mục bản ghi, vốn được dựng trong lúc máy chủ có Premium và được bổ sung cho cả kho cũ của bạn ở lần nâng cấp đầu tiên. Ticket đóng trước lúc nâng cấp (hoặc trong khi việc bổ sung chỉ mục còn đang chạy) sẽ trả về indexed: false cùng mảng messages rỗng. Với những ticket đó, hãy dùng Lấy bản ghi dạng HTML hoặc transcript.TranscriptUrl. Ticket dài thì lật trang bằng đối tượng pagination.

Ví dụ về yêu cầu
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>?limit=500"
Ví dụ về phản hồi
{
  "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 }
}