API 연동하기

티켓타코 API로 이벤트, 주문, 티켓, 참가신청 정보를 조회해 CRM이나 사내 시스템과 연동해보세요. 변경사항을 실시간으로 받아야 한다면 웹훅을 함께 사용하세요.

사내 시스템 → GET https://api.ticketa.co/v1/events/{event_id}/tickets → 티켓 목록 저장

API 목록, 오류 코드 등 사용 정보는 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 파라미터로 마지막 조회 이후 변경된 주문, 티켓, 참가신청만 조회할 수 있습니다.

  1. 처음에는 updated_since 없이 전체 목록을 조회해 저장합니다.
  2. 이후에는 직전 조회를 시작한 시간을 updated_since로 보내 변경된 목록만 조회합니다.
  3. 응답받은 데이터는 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"