자주 묻는 질문 (FAQ)

ONDA API 연동과 관련하여 자주 묻는 질문들을 정리했습니다.

기본 정보

Q. ONDA Hub가 무엇인가요?

ONDA Hub는 숙박 상품 공급자와 판매 채널을 연결하는 통합 유통 플랫폼입니다.

Vendor(공급자): 숙박 상품을 ONDA에 공급하고 70+ 채널에 판매
Channel(판매자): ONDA의 25,000+ 숙박 상품을 판매

RESTful 기반의 API를 통해 실시간 재고/가격 조회, 예약 처리 등을 수행할 수 있습니다.

Q. Vendor와 Channel 파트너의 차이는 무엇인가요?

Vendor Partner (공급자)

호텔, 리조트, 펜션 등 숙박 시설
PMS 시스템 제공사
호텔 체인 및 상품 공급사
목적: 숙박 상품을 ONDA에 공급하고 여러 채널에 판매

Channel Partner (판매자)

OTA (Online Travel Agency)
여행사 및 메타서치 엔진
숙박 예약 플랫폼
목적: ONDA의 숙박 상품을 자사 플랫폼에서 판매

Q. 어떤 파트너 유형을 선택해야 하나요?

귀사의 비즈니스 모델에 따라 선택하세요:

숙박 상품을 공급하시나요? → Vendor API 사용
숙박 상품을 판매하시나요? → Channel API 사용

자세한 내용은 시작하기 페이지를 참고하세요.

시작하기

Q. API 연동 개발 기간은 얼마나 걸리나요?

평균 개발 기간

Channel API: 약 2주 (평균)
Vendor API: 약 1개월 (1 M/M)

실제 개발 기간은 구현 범위와 개발 리소스에 따라 달라질 수 있습니다.

Q. API 키는 어떻게 발급받나요?

발급 절차

ONDA와 파트너 계약 체결
개발 환경용 API 키 발급
개발 및 테스트 진행
운영 환경용 API 키 발급
정식 서비스 시작

문의

파트너 신청: 문의하기
기술 문의: techsupport@onda.me

Q. 테스트 환경은 어떻게 구성하나요?

ONDA는 개발과 운영 환경을 분리하여 제공합니다:

개발 환경

URL: https://dapi.tport.dev
용도: API 연동 개발 및 테스트

운영 환경

URL: https://gds.tport.io
용도: 실제 서비스 운영

각 환경별로 별도의 API 키가 발급됩니다.

기술 스펙

Q. API 엔드포인트는 어디인가요?

개발 환경

https://dapi.tport.dev

운영 환경

https://gds.tport.io

모든 API는 HTTPS 프로토콜을 사용합니다.

Q. 어떤 데이터 형식을 사용하나요?

기본 정보

프로토콜: HTTPS
데이터 형식: JSON (UTF-8 인코딩)
HTTP 메서드: GET, POST, PUT, PATCH, DELETE
Content-Type: application/json

모든 요청과 응답은 JSON 형식으로 처리됩니다.

Q. API 인증은 어떻게 하나요?

Channel API 인증

HTTP 헤더에 다음 두 가지 키를 포함해야 합니다:

Authorization Key
- 헤더: x-api-key
- ONDA에서 발급한 API 인증 키
Channel Key
- 헤더: x-channel-key
- 채널사를 구분하는 고유 키

Vendor API 인증

ONDA에서 제공하는 인증 방식에 따라 진행되며, 계약 시 상세 안내됩니다.

연동 방식

Q. Real Time Type과 DB Cache Type의 차이는 무엇인가요?

Real Time Type

고객이 검색할 때마다 ONDA API를 실시간으로 호출
DB에 재고/요금 저장 불필요
Webhook 개발 불필요
구현이 상대적으로 간단

DB Cache Type

모든 상품의 재고/요금을 채널 DB에 저장
고객 검색 시 자체 DB 조회 (빠른 응답)
Webhook 개발 필수 (실시간 업데이트)
대용량 트래픽 처리에 유리

자세한 내용은 다음 문서를 참고하세요:

Q. Webhook은 무엇이고 언제 필요한가요?

Webhook이란?

ONDA에서 변경된 정보를 실시간으로 채널에 알려주는 Push 방식의 API입니다.

Webhook 종류

contents_updated: 숙소/객실/패키지 콘텐츠 변경 알림
status_updated: 상품 추가 또는 판매상태 변경 알림
inventory_updated: 요금/재고 변경 알림

필요한 경우

DB Cache Type 연동 시 필수
Real Time Type에서는 선택사항

자세한 내용은 Webhook 개요를 참고하세요.

Q. ONDA → Vendor와 Vendor → ONDA 방식의 차이는?

Vendor API는 두 가지 연동 방식을 제공합니다:

ONDA → Vendor (Pull 방식)

ONDA에서 Vendor 시스템의 API를 호출
실시간 데이터 동기화
Vendor는 API를 제공하고 응답

Vendor → ONDA (Push 방식)

Vendor에서 ONDA API를 호출하여 정보 업데이트
변경사항 발생 시 즉시 전송
ONDA가 데이터를 수신하고 저장

대부분의 경우 두 방식을 함께 사용합니다.

예약 및 테스트

Q. 테스트용 숙소는 어떻게 사용하나요?

테스트용 Property ID

Property ID	분류	Rateplan 포함
117417	호텔	포함
120135	호텔	포함

주의사항

실제 숙소로는 테스트할 수 없습니다
위 테스트 숙소로만 예약 테스트를 진행해야 합니다
예약 테스트 후 반드시 취소 처리를 완료해야 합니다

자세한 내용은 예약 테스트 숙소를 참고하세요.

Q. 실제 숙소 콘텐츠는 조회할 수 있나요?

가능합니다 (단, 조건부)

담당 매니저와 사전 협의 필요
실제 숙소의 콘텐츠 정보까지는 조회 가능
단, 예약 테스트는 절대 불가 (테스트 숙소만 사용)

실제 숙소로 예약을 생성하면 실제 예약이 발생하므로 주의가 필요합니다.

기술 지원

Q. 기술 문의는 어디로 하나요?

문의 채널

기술 문의: techsupport@onda.me
파트너 신청: 문의하기

지원 시간

평일 10:00 - 18:00 (KST)
긴급 장애: 24/7 대응

이메일로 문의 시 다음 정보를 포함해주세요:

파트너사명
API 유형 (Vendor/Channel)
환경 (개발/운영)
구체적인 문의 내용

Q. API 장애 발생 시 어떻게 대응하나요?

긴급 장애 대응

24/7 긴급 대응 체계 운영
techsupport@onda.me로 즉시 문의

장애 문의 시 포함 정보

발생 시간
에러 메시지 또는 응답 코드
요청 파라미터 (민감 정보 제외)
재현 가능 여부

빠른 해결을 위해 구체적인 정보를 제공해주세요.

추가 문서

더 자세한 정보는 다음 문서를 참고하세요:

기본 정보​

시작하기​

기술 스펙​

연동 방식​

예약 및 테스트​

기술 지원​

추가 문서​