13
API 참조
TicketsX REST API를 쓰면 외부 도구를 서버의 티켓 시스템과 연결할 수 있습니다. Discord 화면을 거치지 않고 코드로 티켓을 만들고 닫고 관리하며, 보관된 대화 기록 전체를 검색하고, 닫힌 티켓의 전체 본문이나 HTML을 가져올 수 있습니다.
REST API는 프리미엄 기능입니다. API 토큰은 서버에 프리미엄 구독이 살아 있는 동안에만 만들고 쓸 수 있습니다(요금 페이지 참고). 프리미엄이 없는 서버의 요청은 402와 premium_required: true 필드로 거절됩니다. 프리미엄이 끝나면 기존 토큰은 남아 있지만 다시 활성화할 때까지 동작하지 않습니다. 그동안에도 대시보드에서 토큰을 확인하고 비활성화하고 폐기할 수 있습니다.
https://api.ticketsx.xyz모든 요청에는 Authorization 헤더에 Bearer 토큰으로 전달하는 API 토큰이 필요합니다. 토큰은 서버 하나에만 쓸 수 있고, 작업별로 권한을 제한할 수 있습니다.
Authorization: Bearer <API_TOKEN>아래 엔드포인트 경로에서 <guild_id>는 Discord 서버 ID로, <ticket_id>는 대상 티켓의 ID로 바꾸세요.
모든 POST 요청 본문에는 Content-Type: application/json이 필요합니다. 4xx 응답에는 JSON error 필드가 들어갑니다. 401은 토큰이 잘못되었거나 만료되었거나 폐기되었다는 뜻이고, 402는 서버에 프리미엄이 없다는 뜻이며(응답에 premium_required: true도 함께 들어갑니다), 403은 토큰이 비활성 상태이거나 필요한 권한이 없다는 뜻이고, 429는 요청 제한에 걸렸다는 뜻으로(요청 제한과 안전 항목 참고) 초 단위 retry_after 값이 함께 들어갑니다.