Changelog
API 변경 이력
ONDA Channel API의 버전별 변경 사항, 새 기능, 개선 및 수정 내역을 확인하세요.
v2.x (현재)v1.x (deprecated)
v1.x API는 2026년 6월 30일부터 지원이 중단됩니다. v2.0 마이그레이션 가이드를 참고하세요.
v2.1.0
새 기능
- 웹훅 API 추가: 실시간 이벤트 알림을 위한 웹훅 구독 관리 API 추가
POST /webhooks - 웹훅 등록GET /webhooks - 웹훅 목록 조회DELETE /webhooks/{id} - 웹훅 삭제
- 복수 숙소 가격 검색: 한 번의 요청으로 여러 숙소의 가격을 조회할 수 있는 배치 API 추가
POST /search/rates/batch
- 예약 확인서 이메일 발송: 예약 확인서를 이메일로 직접 발송하는 기능 추가
POST /reservations/{id}/send-voucher
개선
- 검색 API 응답 시간 30% 단축 (평균 187ms -> 131ms)
- 재고 검색 정확도 향상
- 에러 메시지에 request_id 필드 추가하여 디버깅 개선
변경
- GET /properties 응답에 languages 필드 추가 (지원 언어 목록)
- 예약 생성 시 special_requests 최대 길이 200자 -> 500자로 확대
v2.0.0Breaking Changes
주요 변경 (Breaking Changes)
- OAuth 2.0 인증 전환: API Key 방식에서 OAuth 2.0으로 인증 방식 변경
Client Credentials 플로우 지원Authorization Code + PKCE 플로우 지원Access Token 유효 기간: 15분Refresh Token 유효 기간: 30일
- API 버전 경로 변경: /api/v1 -> /v1 (기존 경로는 2026년 6월 30일까지 지원)
새 기능
- 다국어 지원 확대: 중국어 간체/번체 추가 (기존: 한국어, 영어, 일본어)
- 위치 기반 검색: 위경도 및 반경을 사용한 검색 지원
- 필터링 옵션 추가
price_min, price_max - 가격 범위 필터amenities - 편의시설 필터property_types - 숙소 타입 필터
개선
- Rate limit 상한 증가: 500 -> 1000 요청/분
- 검색 결과 페이지네이션 최대 항목 수 증가: 50 -> 100
v1.5.0
새 기능
- 검색 API 정렬 옵션: sort_by 파라미터 추가
price_asc, price_desc, rating, distance, popularity
- 예약 날짜 변경 API: 기존 예약의 날짜를 변경할 수 있는 API 추가
POST /reservations/{id}/modify-dates
- 취소 가능 여부 조회: 실제 취소하지 않고 환불 금액을 미리 확인
GET /reservations/{id}/cancellation-fee
개선
- 객실 타입 정보에 connecting_rooms_available 필드 추가
- 패키지 정보에 blackout_dates 필드 추가
- 예약 목록 조회 성능 40% 향상
수정
- 빈방 검색 시 만실 숙소가 간헐적으로 포함되는 버그 수정
- 가격 검색 시 세금 계산 오류 수정
v1.4.0
새 기능
- 이미지 최적화: CDN 이미지 URL에 크기 조정 파라미터 지원
?w=1200&h=800&fit=crop&q=85
- 예약 확인서 생성: PDF/HTML 형식의 예약 확인서 생성
GET /reservations/{id}/voucher
개선
- 숙소 상세 조회 시 주변 랜드마크 정보 추가
- 패키지 정보에 additional_inclusions 필드 추가 (포함 서비스 목록)
v1.3.0
새 기능
- 복수 객실 예약: 하나의 예약에 여러 객실 포함 가능
- 조식 상세 정보: 패키지에 조식 타입, 제공 시간 등 상세 정보 추가
개선
- 검색 API 응답에 search_time_ms 필드 추가 (성능 모니터링)
- 에러 응답에 validation_errors 배열 추가 (상세한 검증 오류 정보)
v1.2.0
새 기능
- Sandbox 환경: 개발 및 테스트를 위한 Sandbox 환경 제공
Base URL: https://sandbox.api.onda.me/v1
개선
- 예약 생성 시 재고 부족, 가격 변동 에러 메시지 개선
- API 문서에 코드 예제 추가 (Python, Node.js, cURL)
v1.1.0
새 기능
- 패키지 상세 정보: 취소 정책, 결제 정책 상세 정보 추가
- 예약 상태 추가: checked_in, checked_out, no_show 상태 추가
개선
- 가격 응답에 일자별 breakdown 추가 (nightly_breakdown)
- 숙소 목록 조회 시 include 파라미터로 선택적 필드 로딩
v1.0.1
수정
- 일부 숙소의 편의시설 정보가 누락되는 버그 수정
- 검색 결과 페이지네이션 오류 수정
v1.0.0
최초 출시
- ONDA Channel API 정식 출시
- 숙소, 객실, 패키지 정보 조회
- 빈방 및 가격 검색
- 예약 생성, 조회, 취소
- RESTful API 설계, JSON 응답 형식
- API Key 인증
자세한 API 명세는 API 레퍼런스를 참고하세요.
인증 방식 변경에 대한 안내는 OAuth 2.0 인증 가이드를 참고하세요.