인증

API 토큰은 TicketsX 대시보드의 서버 사이드바에서 만들고 관리합니다. 토큰은 서버 하나에 묶이며, 토큰을 만들거나 쓰려면 서버에 프리미엄 구독이 살아 있어야 합니다.

토큰 만들기

• 프리미엄 페이지에서 서버의 프리미엄을 활성화합니다(API 접근 페이지에 바로 가는 링크가 있습니다).
• 서버 사이드바를 열고 API 접근으로 이동합니다.
• 토큰 이름을 정합니다(예: "지원 봇", "CRM 연동").
• 토큰 만들기를 누르고 표시된 값을 복사합니다.
• 비밀 정보 저장소에 보관하세요. 안내 창을 닫은 뒤에는 다시 볼 수 없습니다.

프리미엄이 끝나면

토큰은 지워지지 않습니다. 구독이 다시 살아날 때까지 모든 API 요청이 402와 premium_required: true를 돌려주고, 토큰을 만들거나 교체하는 일도 막힙니다. 토큰 목록 보기, 비활성화, 폐기는 계속 동작하므로 정리는 언제든 할 수 있습니다. 연동에서는 402를 401과 똑같이 처리하세요. 재시도를 멈추고 사람에게 알리면 됩니다.

{
  "error": "The TicketsX REST API is a Premium feature. Activate Premium for this server to use API tokens.",
  "premium_required": true
}

토큰 사용하기

모든 요청에 토큰을 Bearer 헤더로 보내세요. 모든 요청은 그 토큰을 만든 서버에만 적용됩니다.

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