문서

TicketsX를 더 빠르게 익히세요

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

13.6

참여자 추가

POST/<guild_id>/api/tickets/<ticket_id>/participants

사용자나 역할에 티켓 채널 접근 권한을 줍니다. 대상은 그 티켓에서 읽기와 쓰기 권한을 받습니다.

요청 본문

이름형식필수설명
target_idstring
필수
추가할 Discord 사용자 ID 또는 역할 ID.
target_typestring
선택
대상의 종류. user 또는 role(기본값 user).

스레드 티켓에는 역할 단위 권한 설정이 없기 때문에, role을 추가하면 소속 구성원을 한 명씩 추가하며 남용을 막으려고 앞에서부터 25명까지만 처리합니다. 목록이 잘리면 응답에 note 필드가 들어갑니다. 채널 티켓에는 이런 제한이 없습니다(권한 설정 하나로 역할 전체가 처리됩니다).

요청 예시
curl -X POST \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"target_id":"111222333","target_type":"user"}' \
  https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/participants