객체
티켓타코 개발자도구에서 사용하는 객체 정보를 살펴보세요.
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입니다.