본문으로 건너뛰기

Vendor API

온다 Vendor API는 숙박업체(벤더)와 온다 플랫폼 간의 원활한 데이터 연동을 위한 RESTful API입니다.

개요​

Vendor API를 통해 숙박업체는 다음과 같은 작업을 수행할 수 있습니다:

  • 숙소 정보 동기화: 온다에서 업데이트된 숙소 정보 확인
  • 객실 정보 관리: 객실 타입 및 상세 정보 동기화
  • 요금 정보 연동: 실시간 요금 정보 업데이트
  • 예약 가능 여부: 재고 및 예약 가능 상태 관리

API 연동 방식​

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

1. ONDA → Vendor (Pull 방식)​

온다에서 벤더 시스템으로 데이터를 요청하는 방식

  • 온다가 벤더 API를 호출하여 최신 정보 획득
  • 실시간 데이터 동기화
  • 벤더 시스템의 능동적 응답 필요

2. Vendor → ONDA (Push 방식)​

벤더에서 온다 시스템으로 데이터를 전송하는 방식

  • 벤더가 온다 API를 호출하여 정보 업데이트
  • 변경사항 발생 시 즉시 전송
  • 온다 시스템의 수동적 수신

시작하기​

Vendor API 연동을 시작하려면 다음 단계를 따르세요:

  1. 파트너십 협약: 온다 사업팀과 파트너십 계약 체결
  2. API 인증 정보 발급: 개발 및 운영 환경용 API 키 발급
  3. 기술 문서 검토: API 명세서 및 연동 가이드 확인
  4. 개발 환경 구축: 테스트 환경에서 API 연동 개발
  5. 테스트 및 검증: 연동 기능 테스트 및 성능 검증
  6. 운영 배포: 운영 환경 배포 및 모니터링

주요 특징​

  • RESTful API: 표준 HTTP 메서드 사용
  • JSON 포맷: 요청/응답 데이터는 JSON 형식
  • 인증 보안: API 키 기반 인증 시스템
  • 실시간 동기화: 실시간 데이터 연동 지원
  • 에러 핸들링: 상세한 에러 코드 및 메시지 제공

다음 단계에서는 구체적인 연동 방식별 가이드를 확인하세요.