객체

티켓타코 개발자도구에서 사용하는 객체 정보를 살펴보세요.

Event 객체

이벤트 정보를 담고 있는 객체입니다. 이벤트의 공개 상태와 일정을 알 수 있습니다.

객체 상세


id string
이벤트의 고유 식별자입니다.


title string
이벤트의 이름입니다.


status string
이벤트 공개 상태입니다.

  • private: 비공개 상태입니다.
  • unlisted: 일부공개 상태입니다. 링크가 있는 사람만 접근할 수 있습니다.
  • public: 공개 상태입니다.

start_at string
이벤트가 시작하는 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


end_at string
이벤트가 종료되는 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


created_at string
이벤트를 생성한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


Order 객체

주문 정보를 담고 있는 객체입니다. 주문 한 건의 상태, 예매자, 결제 시간 등을 자세히 알 수 있습니다. 하나 이상의 Ticket이 포함됩니다.

객체 상세


order_number string
주문 고유 번호입니다.


event_id string
예매한 이벤트의 고유 식별자입니다.


name string
예매한 이벤트의 이름입니다.


quantity number
주문에 포함된 티켓 수량입니다.


total_amount number
총 결제 금액입니다. 단위는 원(KRW)입니다. 티켓이 취소되는 등 상태가 변해도 최초에 결제된 결제 금액으로 유지됩니다.


refund_amount number
지금까지 환불된 누적 금액입니다. 단위는 원(KRW)입니다.


tickets Ticket[]
주문에 포함된 Ticket 객체 배열입니다.


purchaser User
예매자의 User 객체입니다.


sale_channel string
주문이 이루어진 판매 채널입니다.

  • platform: 티켓타코에서 예매자가 직접 예매했습니다.
  • admin: 관리자가 발권했습니다.

attribution nullable Attribution
예매자가 유입된 경로의 Attribution 객체입니다. 관리자가 발권한 주문처럼 유입 경로 정보가 없으면 null입니다. 추첨·승인 티켓은 참가신청할 때의 유입 경로가 담깁니다.


status string
주문 상태입니다.

  • paid: 결제가 완료된 상태입니다.
  • canceled: 주문에 포함된 모든 티켓이 취소된 상태입니다.

paid_at string
결제를 완료한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


canceled_at nullable string
주문이 취소된 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


Ticket 객체

티켓 정보를 담고 있는 객체입니다. 개별 티켓의 상태, 소유자, 체크인 시간 등을 자세히 알 수 있습니다.

객체 상세


ticket_number string
티켓 고유 번호입니다.


order_number string
티켓이 속한 주문의 고유 번호입니다.


event_id string
예매한 이벤트의 고유 식별자입니다.


sale_phase_name nullable string
티켓이 판매된 판매 단계의 이름입니다. 예: “얼리버드”, “일반 판매”


ticket_type_name string
티켓 종류의 이름입니다. 예: “일반 참가권”, “VIP 참가권”


seat nullable Seat
좌석의 Seat 객체입니다. 좌석이 없는 티켓은 null입니다.


price number
티켓 한 장의 결제 금액입니다. 단위는 원(KRW)입니다. 보증금이 있는 티켓은 보증금이 포함된 금액입니다.


deposit_amount nullable number
티켓 한 장의 결제 금액 중 참가 보증금입니다. 단위는 원(KRW)입니다.


deposit_refunded_at nullable string
참가 보증금이 환불된 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


purchaser User
예매자의 User 객체입니다.


owner User
소유자의 User 객체입니다. 티켓을 양도하면 예매자와 다를 수 있습니다.


attendee nullable User
참가자의 User 객체입니다.


sale_channel string
티켓이 판매된 판매 채널입니다.

  • platform: 티켓타코에서 예매자가 직접 예매했습니다.
  • admin: 관리자가 발권했습니다.

status string
티켓 상태입니다.

  • paid: 결제가 완료된 상태입니다.
  • used: 체크인하여 티켓이 사용된 상태입니다.
  • canceled: 티켓이 취소된 상태입니다.

paid_at string
결제를 완료한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


used_at nullable string
체크인한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


canceled_at nullable string
취소한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


answers Answer[]
티켓 소유자가 참가 양식에 작성한 Answer 객체 배열입니다. 해당 티켓 종류에 적용되는 질문의 답변만 포함되며, 답변이 없으면 빈 배열입니다.


Entry 객체

참가신청 정보를 담고 있는 객체입니다. 추첨·승인 방식 티켓의 신청 상태, 신청자, 결과 시간 등을 자세히 알 수 있습니다.

객체 상세


entry_number string
참가신청 고유 번호입니다.


order_number nullable string
결제가 완료되어 생성된 주문의 고유 번호입니다. 결제 전에는 null입니다.


event_id string
신청한 이벤트의 고유 식별자입니다.


name string
신청한 이벤트의 이름입니다.


sale_phase_name string
신청한 판매 단계의 이름입니다. 예: “1차 추첨”


ticket_type_name string
티켓 종류의 이름입니다. 예: “일반 참가권”, “VIP 참가권”


price number
티켓 한 장의 가격입니다. 단위는 원(KRW)입니다.


quantity number
신청한 티켓 수량입니다.


total_amount number
총 결제 금액입니다. 단위는 원(KRW)입니다. 신청이 취소되는 등 상태가 변해도 최초에 결제된 결제 금액으로 유지됩니다.


applicant User
신청자의 User 객체입니다.


attendees User[]
신청 시 입력한 참가자의 User 객체 배열입니다. 참가자 정보가 없으면 빈 배열입니다.


sale_method string
티켓 판매 방식입니다.

  • lottery: 추첨 방식입니다.
  • approval: 승인 방식입니다.

attribution nullable Attribution
신청자가 유입된 경로의 Attribution 객체입니다.


status string
참가신청 상태입니다.

  • pending: 신청이 접수되어 결과를 대기 중인 상태입니다.
  • approved: 추첨에 당첨되거나 승인된 상태입니다.
  • rejected: 추첨에 미당첨되거나 미승인된 상태입니다.
  • awaiting_payment: 선정되어 결제를 대기 중인 상태입니다.
  • payment_expired: 결제 기한이 초과되어 만료된 상태입니다.
  • paid: 결제가 완료된 상태입니다.
  • canceled: 신청이 취소된 상태입니다.

result_at nullable string
추첨·승인 결과가 발표되는 날짜와 시간입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


payment_due nullable string
선정된 참가신청의 결제 기한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


paid_at nullable string
결제를 완료한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


canceled_at nullable string
취소한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


created_at string
참가신청을 접수한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.


answers Answer[]
신청자가 참가 양식에 작성한 Answer 객체 배열입니다. 해당 티켓 종류에 적용되는 질문의 답변만 포함되며, 답변이 없으면 빈 배열입니다.


User 객체

사용자 정보를 담고 있는 객체입니다.

객체 상세


name nullable string
사용자 이름입니다.


phone nullable string
사용자 전화번호입니다. 국가번호를 포함한 E.164 형식입니다. 예: “+821012345678”


email nullable string
사용자 이메일 주소입니다.


Seat 객체

좌석 정보를 담고 있는 객체입니다.

객체 상세


section nullable string
구역 이름입니다.


row nullable string
열 이름입니다.


number string
좌석 번호입니다.


Answer 객체

참가 양식 질문에 대한 답변 정보를 담고 있는 객체입니다. 질문의 표시 순서대로 정렬되며, 답변하지 않은 질문은 포함되지 않습니다.

객체 상세


question_id number
질문의 고유 식별자입니다.


question string
질문 제목입니다.


type string
질문 유형입니다. 아래와 같은 값을 가질 수 있습니다.

  • short_text: 단답형입니다.
  • long_text: 장문형입니다.
  • radio: 객관식(단일 선택)입니다.
  • checkbox: 체크박스(복수 선택)입니다.
  • dropdown: 드롭다운(단일 선택)입니다.

value string[]
답변 값 배열입니다.


Attribution 객체

예매자나 신청자가 이벤트 페이지에 유입된 경로 정보를 담고 있는 객체입니다.

객체 상세


first object
이벤트 페이지 방문 기록 중 유입원을 알 수 있는 첫 방문의 유입원 정보입니다.


last object
이벤트 페이지 방문 기록 중 유입원을 알 수 있는 마지막 방문의 유입원 정보입니다.

유입원 정보

first, last 객체의 필드입니다.


source string
유입원입니다. utm_source 값이며, UTM 파라미터가 없으면 이전 페이지 주소(referrer)로 판단한 값입니다. 유입원을 알 수 없으면 (direct)입니다.


medium string
유입 매체입니다. utm_medium 값이며, UTM 파라미터가 없으면 이전 페이지 주소(referrer)로 판단한 값입니다. 유입 매체를 알 수 없으면 (none)입니다.


campaign nullable string
캠페인 이름입니다. utm_campaign 값이며, 없으면 null입니다.