ONDA

변경 이력

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

ONDA Platform Engineering 관리

변경 이력

ONDA Channel API의 주요 변경 사항을 기록합니다. 현재 버전은 v1이며, 모든 엔드포인트는 /channel/v1 경로를 사용합니다.

2026-06-01 - v1

Channel API v1 공개

인증

  • API Key(X-Api-Key) 및 OAuth 2.0 Client Credentials 지원
  • POST /oauth/token - Access Token 발급 (oat_ 불투명 토큰, 30분 유효, Refresh Token 미발급)
  • scope 기반 접근 제어 (deny-by-default)

검색

  • GET /search/availability - 가용성 검색 (멀티 숙소)
  • GET /search/availability/{propertyId} - 단일 숙소 검색 (price_check_token 발급)
  • GET /search/rates - 요금 검색
  • GET /search/price-check - 실시간 가격 재확인 및 book_token 발급

예약

  • POST /bookings - 예약 생성 (book_token 필수)
  • GET /bookings, GET /bookings/{id} - 예약 목록/상세 조회
  • PATCH /bookings/{id} - 투숙객 정보 수정
  • PUT /bookings/{id}/cancel - 예약 취소
  • GET /bookings/{id}/cancellation-fee · /cancellation-policy - 취소 수수료/정책 조회

콘텐츠

  • GET /properties, /properties/{id}, /properties/{id}/roomtypes, /properties/{id}/rateplans
  • GET /content/files/content, /content/files/catalog

채널

  • GET /channels/me, PUT /channels/me - 채널 정보 및 정산 계좌 관리

웹훅

  • 예약 이벤트 실시간 알림 (HMAC-SHA256 서명)
  • reservation.created / reservation.modified / reservation.cancelled / reservation.no_show

기타

  • OpenAPI 3.1 명세 제공: GET /channel/v1/openapi.json
  • Rate Limit: Sandbox 60 req/min · Starter(운영) 600 req/min, X-RateLimit-* 응답 헤더 제공

다음 단계