변경 이력

API 변경 이력을 확인하세요.

변경 이력#

ONDA API의 주요 변경 사항을 기록합니다.

2026-02-01 - v2.1.0#

새 기능#

• 웹훅 API 추가: 실시간 이벤트 알림을 위한 웹훅 구독 관리 API 추가

  • POST /webhooks - 웹훅 등록
  • GET /webhooks - 웹훅 목록 조회
  • DELETE /webhooks/{id} - 웹훅 삭제
  • HMAC SHA256 서명 검증 지원

• 복수 숙소 가격 검색: 한 번의 요청으로 여러 숙소의 가격을 조회할 수 있는 배치 API 추가

  • POST /search/rates/batch

• 예약 확인서 이메일 발송: 예약 확인서를 이메일로 직접 발송하는 기능 추가

  • POST /reservations/{id}/send-voucher

개선

• 검색 API 응답 시간 30% 단축 (평균 187ms → 131ms)
• 재고 검색 정확도 향상
• 에러 메시지에 request_id 필드 추가하여 디버깅 개선

변경

• GET /properties 응답에 languages 필드 추가 (지원 언어 목록)
• 예약 생성 시 special_requests 최대 길이 200자 → 500자로 확대

2026-01-15 - v2.0.0#

주요 변경 (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

2025-12-01 - 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% 향상

수정

• 빈방 검색 시 만실 숙소가 간헐적으로 포함되는 버그 수정
• 가격 검색 시 세금 계산 오류 수정

2025-10-15 - v1.4.0#

새 기능#

• 이미지 최적화: CDN 이미지 URL에 크기 조정 파라미터 지원

  • ?w=1200&h=800&fit=crop&q=85

• 예약 확인서 생성: PDF/HTML 형식의 예약 확인서 생성

  • GET /reservations/{id}/voucher

개선

• 숙소 상세 조회 시 주변 랜드마크 정보 추가
• 패키지 정보에 additional_inclusions 필드 추가 (포함 서비스 목록)

2025-09-01 - v1.3.0#

새 기능#

• 복수 객실 예약: 하나의 예약에 여러 객실 포함 가능
• 조식 상세 정보: 패키지에 조식 타입, 제공 시간 등 상세 정보 추가

개선

• 검색 API 응답에 search_time_ms 필드 추가 (성능 모니터링)
• 에러 응답에 validation_errors 배열 추가 (상세한 검증 오류 정보)

2025-07-15 - v1.2.0#

새 기능#

• Sandbox 환경: 개발 및 테스트를 위한 Sandbox 환경 제공
  • Base URL: https://sandbox.api.onda.me/v1

개선

• 예약 생성 시 재고 부족, 가격 변동 에러 메시지 개선
• API 문서에 코드 예제 추가 (Python, Node.js, cURL)

2025-06-01 - v1.1.0#

새 기능#

• 패키지 상세 정보: 취소 정책, 결제 정책 상세 정보 추가
• 예약 상태 추가: checked_in, checked_out, no_show 상태 추가

개선

• 가격 응답에 일자별 breakdown 추가 (nightly_breakdown)
• 숙소 목록 조회 시 include 파라미터로 선택적 필드 로딩

2025-05-01 - v1.0.1#

수정

• 일부 숙소의 편의시설 정보가 누락되는 버그 수정
• 검색 결과 페이지네이션 오류 수정

2025-04-01 - v1.0.0#

최초 출시#

ONDA Channel API 정식 출시

주요 기능:

• 숙소, 객실, 패키지 정보 조회
• 빈방 및 가격 검색
• 예약 생성, 조회, 취소
• RESTful API 설계
• JSON 응답 형식
• API Key 인증

마이그레이션 가이드#

v1.x → v2.0#

OAuth 2.0 인증으로 마이그레이션해야 합니다.

이전 (v1.x):

GET /api/v1/properties
X-API-Key: your_api_key

이후 (v2.0):

# 1. Access Token 발급
POST /v1/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET

# 2. API 호출
GET /v1/properties
Authorization: Bearer YOUR_ACCESS_TOKEN

자세한 내용은 OAuth 2.0 인증 가이드를 참고하세요.

지원 중단 안내#

다음 단계#

• OAuth 2.0 인증 - v2.0 인증 방식
• API 레퍼런스 - 최신 API 명세
• SDK - 공식 SDK 사용