Skip to main content

Vendor API 3.0 문서 공개

신규 연동을 위한 Vendor API 3.0 문서가 공개되었습니다. 기존 Vendor API 1.5는 그대로 지원되며, 상단 메뉴 벤더 API에서 두 버전을 선택할 수 있습니다.

1.5에서 달라진 점​

콘텐츠 전송 방향 반전​

기존에는 ONDA가 공급사 API를 GET으로 호출해 콘텐츠를 가져갔습니다. 3.0에서는 공급사가 ONDA로 직접 전송합니다.

  • 생성 POST /gds/vendor/properties
  • 수정 PATCH /gds/vendor/properties/{vendor_property_id}

조회(GET)는 비상용 옵션으로 유지됩니다.

요금제 모델 신설​

요금제가 객실타입 × 요금제 모델의 결합으로 정의됩니다. 요금제 모델은 숙소 단위로 생성하며, standalone은 숙소당 1개 필수, package는 개수 제한이 없습니다.

요금·재고 전송 분리​

  • 요금·영업일 → POST .../ari (요금제 단위)
  • 재고 → POST .../ari/avails (객실타입 단위 통합 재고)

두 호출 모두 전 채널 공통 값과 채널별 값(channels[])을 한 번에 담아 전송합니다.

채널 API 추가​

채널 탐색, 오픈 신청, 채널별 설정, 숙소·객실·요금제 매핑을 API로 처리합니다.

문서 구성​

구분내용
연동 가이드준비부터 채널 오픈, 예약 운영, 취소환불 정책까지 12장
API 레퍼런스HUB API 38개 + 공급사 API 5개 = 43개 엔드포인트

HUB API(공급사 → ONDA)에서 공급사는 클라이언트이고, 공급사 API(ONDA → 공급사)에서는 공급사가 서버입니다. 예약 생성·확정·변경·취소와 취소환불 정책 조회는 공급사가 직접 구현해야 하는 엔드포인트입니다.

AI 개발 지원​

AI 개발 지원 페이지에서 Vendor API 3.0 전용 컨텍스트 파일(Claude Code · Cursor · Windsurf)을 내려받을 수 있습니다.

참고​

  • 개발(alpha) 환경 베이스 URL: https://vendor.dapi.tport.dev
  • 운영 환경 URL과 access token은 연동 계약 후 ONDA 담당자가 안내합니다