API 연동하기
티켓타코 API로 이벤트, 주문, 티켓, 참가신청 정보를 조회해 CRM이나 사내 시스템과 연동해보세요. 변경사항을 실시간으로 받아야 한다면 웹훅을 함께 사용하세요.
사내 시스템 → GET https://api.ticketa.co/v1/events/{event_id}/tickets → 티켓 목록 저장
API 목록, 오류 코드 등 사용 정보는 API 레퍼런스를 참고해주세요.
API 키 발급
개발자센터의 API 키 메뉴에서 발급 버튼을 누르고 API 키 이름을 입력하세요.

- 발급된 API 키는 발급 직후 한 번만 볼 수 있습니다. 창을 닫기 전에 복사해서 안전한 곳에 보관해주세요.
- API 키는 서버에서만 사용해주세요. 브라우저나 앱 코드에 포함하면 누구나 키를 볼 수 있습니다.
- API 키가 노출되었다면 바로 폐기하고 새로 발급해주세요. 폐기한 키는 즉시 사용할 수 없게 되며, 되돌릴 수 없습니다.
- 조직당 최대 10개의 API 키를 발급할 수 있습니다.
첫 요청 보내기
발급한 API 키를 Authorization 헤더에 담아 이벤트 목록을 조회해보세요.
curl "https://api.ticketa.co/v1/events" \
-H "Authorization: Bearer ttsk_xxxxxxxxxxxxxxxx"
조직의 이벤트 목록이 응답됩니다. 응답의 id가 주문, 티켓, 참가신청 목록을 조회할 때 사용하는 이벤트의 고유 식별자입니다.
{
"data": [
{
"id": "a1b2c3d4",
"title": "FEConf 2025",
"status": "public"
// ...
}
],
"has_more": false,
"next_cursor": null
}
전체 목록 조회하기
목록은 페이지 단위로 응답됩니다. 응답의 has_more가 true이면 next_cursor 값을 cursor 파라미터로 보내 다음 페이지를 요청하세요. 아래는 이벤트의 티켓을 모두 조회하는 예시입니다.
const API_KEY = process.env.TICKETACO_API_KEY;
async function fetchAllTickets(eventId) {
const tickets = [];
let cursor = null;
do {
const url = new URL(`https://api.ticketa.co/v1/events/${eventId}/tickets`);
url.searchParams.set("limit", "250");
if (cursor) url.searchParams.set("cursor", cursor);
const response = await fetch(url, { headers: { Authorization: `Bearer ${API_KEY}` } });
if (!response.ok) {
const { error } = await response.json();
throw new Error(`${error.code}: ${error.message}`);
}
const page = await response.json();
tickets.push(...page.data);
cursor = page.has_more ? page.next_cursor : null;
} while (cursor);
return tickets;
}
티켓 목록 조회 등 일부 API는 format=csv로 요청하면 전체 목록을 CSV 파일로 받을 수도 있습니다.
변경된 정보만 조회하기
매번 전체 목록을 조회하지 않고 updated_since 파라미터로 마지막 조회 이후 변경된 주문, 티켓, 참가신청만 조회할 수 있습니다.
- 처음에는
updated_since없이 전체 목록을 조회해 저장합니다. - 이후에는 직전 조회를 시작한 시간을
updated_since로 보내 변경된 목록만 조회합니다. - 응답받은 데이터는
order_number,ticket_number,entry_number를 기준으로 덮어씁니다.
조회하는 동안 생긴 변경을 놓치지 않으려면 조회가 끝난 시간이 아니라 시작한 시간을 기준으로 삼아야 합니다. 서버 간 시간 차이를 고려해 1분 정도 여유를 두는 것을 권장합니다. 예를 들어 14:30에 조회를 시작했다면, 다음 조회에서는 14:29를 updated_since로 보냅니다.
curl "https://api.ticketa.co/v1/events/a1b2c3d4/tickets?updated_since=2025-04-07T14:29:00.000Z" \
-H "Authorization: Bearer ttsk_xxxxxxxxxxxxxxxx"