13
Tham chiếu API
REST API của TicketsX cho bạn nối các công cụ bên ngoài với hệ thống ticket của máy chủ mình. Bạn tạo, đóng và quản lý ticket bằng mã lệnh mà không cần giao diện Discord, tìm trong toàn bộ kho bản ghi, và lấy về trọn phần chữ hoặc mã HTML của bất kỳ ticket nào đã đóng.
REST API là tính năng Premium. Khóa API chỉ tạo được và dùng được trong lúc máy chủ còn gói Premium hiệu lực (xem trang bảng giá). Yêu cầu từ máy chủ không có Premium bị từ chối với mã 402 cùng trường premium_required: true. Nếu Premium hết hạn, khóa của bạn vẫn được giữ nhưng ngừng chạy cho tới khi bạn bật lại. Trong lúc đó bạn vẫn liệt kê, tắt và thu hồi khóa được từ bảng điều khiển.
https://api.ticketsx.xyzMọi yêu cầu đều cần một khóa API gửi kèm dưới dạng khóa Bearer trong tiêu đề Authorization. Khóa chỉ có giá trị ở một máy chủ và giới hạn được cho từng thao tác.
Authorization: Bearer <API_TOKEN>Ở mọi đường dẫn bên dưới, hãy thay <guild_id> bằng mã máy chủ Discord của bạn và <ticket_id> bằng mã của ticket cần dùng.
Mọi phần thân của yêu cầu POST đều cần Content-Type: application/json. Các phản hồi 4xx có kèm trường JSON error; 401 nghĩa là khóa không hợp lệ, đã hết hạn hoặc bị thu hồi; 402 nghĩa là máy chủ không có Premium (phản hồi còn mang theo premium_required: true); 403 nghĩa là khóa đang tắt hoặc thiếu quyền cần thiết; 429 nghĩa là bạn đã chạm giới hạn (xem phần Giới hạn và an toàn) và có kèm giá trị retry_after tính bằng giây.