13.2
티켓 목록
GET
/<guild_id>/api/tickets서버에서 열려 있는 티켓 목록을 가져옵니다. 담당 상태, 사용자, 개설자로 결과를 좁히는 질의 필터를 쓸 수 있습니다.
질의 매개변수
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| filter | string | 선택 | 상태로 티켓을 거릅니다. 쓸 수 있는 값: claimed, mine. |
| user_id | string | 선택 | 이 사용자가 참여한 티켓만 거릅니다. |
| creator_id | string | 선택 | 이 사용자 ID가 만든 티켓만 거릅니다. |
| limit | number | 선택 | 한 번에 가져올 개수, 1~100(기본값 50). |
| offset | number | 선택 | 페이지를 넘기려고 건너뛸 결과 수(기본값 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"