문서

TicketsX를 더 빠르게 익히세요

설정 안내, 전체 명령어 목록, Premium 기능, REST API를 한곳에 모았습니다.

13.2

티켓 목록

GET/<guild_id>/api/tickets

서버에서 열려 있는 티켓 목록을 가져옵니다. 담당 상태, 사용자, 개설자로 결과를 좁히는 질의 필터를 쓸 수 있습니다.

질의 매개변수

이름형식필수설명
filterstring
선택
상태로 티켓을 거릅니다. 쓸 수 있는 값: claimed, mine.
user_idstring
선택
이 사용자가 참여한 티켓만 거릅니다.
creator_idstring
선택
이 사용자 ID가 만든 티켓만 거릅니다.
limitnumber
선택
한 번에 가져올 개수, 1~100(기본값 50).
offsetnumber
선택
페이지를 넘기려고 건너뛸 결과 수(기본값 0).

응답에는 pagination 객체가 들어갑니다: { total, limit, offset, returned }. 열려 있는 티켓만 돌려줍니다.

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