Vendor API 3.0
ONDA Vendor API 3.0은 공급사(Vendor)와 ONDA 플랫폼을 연동하는 RESTful API입니다. 공급사는 숙소·객실·요금제 콘텐츠와 요금·재고를 ONDA로 전송하고, ONDA는 OTA 채널에서 발생한 예약을 공급사로 전달합니다.
1.5 버전을 쓰고 계신가요?
기존 Vendor API 1.5는 계속 지원됩니다. 신규 연동은 3.0을 사용하세요.
연동의 두 방향
3.0에서 가장 먼저 이해해야 할 것은 API 호출 방향입니다. 공급사는 클라이언트이면서 동시에 서버입니다.
| 구분 | 방향 | 경로 패턴 | 공급사의 역할 |
|---|---|---|---|
| HUB API | 공급사 → ONDA | /gds/vendor/... | 클라이언트 — ONDA API를 호출 |
| 공급사 API | ONDA → 공급사 | /bookings 등 | 서버 — ONDA가 호출할 엔드포인트를 제공 |
채널 유형
판매 채널은 플러스 채널(channel_type=hub)과 직연동 채널(channel_type=cms)로 나뉩니다. 플러스 채널은 계약·입점·정산까지 ONDA가 대행하고, 직연동 채널은 숙소가 OTA와 직접 계약해 운영합니다. 요금·재고 동기화는 두 유형 모두 ONDA를 거칩니다.
이 구분에 따라 채널 오픈 절차와 예약 처리 방식이 달라집니다. 자세한 비교는 공통 · 개요를 참고하세요.
1.5에서 달라진 점
- 콘텐츠 방향 반전 — ONDA가
GET으로 가져가던 방식에서, 공급사가POST·PATCH로 직접 전송하는 방식으로 바뀌었습니다. - 요금제 모델 신설 — 요금제는
객실 × 요금제 모델의 결합으로 정의됩니다. - 요금재고 전송 분리 — 요금·영업일은
POST .../ari, 재고는POST .../ari/avails로 나뉩니다. - 채널 API 추가 — 채널 탐색·오픈 신청·설정·매핑을 API로 처리합니다.
콘텐츠 4분류
| 분류 | 생성 | 수정 |
|---|---|---|
| 숙소 | POST /gds/vendor/properties | PATCH /gds/vendor/properties/{vendor_property_id} |
| 객실타입 | POST .../{vendor_property_id}/roomtypes | PATCH .../roomtypes/{vendor_roomtype_id} |
| 요금제 모델 | POST .../{vendor_property_id}/rateplan-models | PATCH .../rateplan-models/{vendor_rateplan_model_id} |
| 요금제 | POST .../roomtypes/{vendor_roomtype_id}/rateplans | PATCH .../rateplans/{vendor_rateplan_id} |
인증
HUB API 호출 시 Authorization 헤더에 발급받은 Vendor access token을 담습니다.
GET /gds/vendor/meta HTTP/1.1
Authorization: {vendor_access_token}
베이스 URL
| 환경 | URL |
|---|---|
| 개발(alpha) | https://vendor.dapi.tport.dev |
| 운영 | 연동 계약 후 ONDA 담당자가 안내 |
토큰은 연동 계약 후 ONDA 담당자가 발급합니다.
공급사 API는 반대로 공급사가 인증을 검증하는 쪽입니다. ONDA 요청에 대한 토큰·서명 검증 로직을 구현해야 합니다.
공통 규칙
- 생성
POST· 수정PATCH· 조회GET, 성공 응답은200 OK PATCH는 RFC 7396 Merge Patch를 따릅니다. 생략한 필드는 기존값이 유지됩니다.- 요청·응답 본문은 JSON입니다.
- 날짜·시각은 ISO 8601을 사용합니다. (예:
2026-01-20T15:00:00+09:00)
시작하기
- 파트너십 협약 — ONDA 사업팀과 연동 계약 체결
- 인증 정보 발급 — 스테이징·운영 환경 access token 및 베이스 URL 수령
- 연동 가이드 검토 — 준비부터 채널 오픈, 예약 운영까지 순서대로 정리돼 있습니다
- 코드 카탈로그 조회 —
GET /gds/vendor/meta로 코드 값을 내려받아 매핑 테이블 구성 - 스테이징 검증 후 운영 전환
연동 순서대로 따라가려면 연동 가이드부터 확인하세요. 엔드포인트별 상세 스펙은 API 레퍼런스에 있습니다.