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 담당자가 안내합니다