API 변경 이력

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)
• 검색: 가용성·요금 검색 및 book_token 발급 흐름
  • GET /search/availability - 가용성 검색 (멀티 숙소)
  • GET /search/availability/{propertyId} - 단일 숙소 검색 (price_check_token 발급)
  • GET /search/rates - 요금 검색
  • GET /search/price-check - 실시간 가격 재확인 및 book_token 발급
• 예약: 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-* 응답 헤더 제공