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.2

Liệt kê ticket

GET/<guild_id>/api/tickets

Lấy danh sách các ticket đang mở của máy chủ. Có bộ lọc tùy chọn để thu hẹp kết quả theo tình trạng nhận ticket, theo người dùng hoặc theo người mở ticket.

Tham số truy vấn

Tên	Kiểu	Bắt buộc	Mô tả
filter	string	tùy chọn	Lọc ticket theo tình trạng. Giá trị nhận được: `claimed`, `mine`.
user_id	string	tùy chọn	Lọc những ticket có người dùng này tham gia.
creator_id	string	tùy chọn	Lọc những ticket do mã người dùng này tạo ra.
limit	number	tùy chọn	Số kết quả mỗi trang, 1-100 (mặc định 50).
offset	number	tùy chọn	Số kết quả bỏ qua khi phân trang (mặc định 0).

Phản hồi có kèm đối tượng pagination: { total, limit, offset, returned }. Chỉ những ticket đang mở mới được trả về.

Ví dụ về yêu cầu

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/tickets?filter=claimed&creator_id=123456789"