정보 최신화
공급사에서 변경한 숙소 정보를 온다에 업데이트합니다.
2가지 방식으로 변경된 숙소 정보를 관리할 수 있습니다.
Sync : 온다가 공급사를 호출
- 정해진 시간마다 온다가 공급사를 호출해 변경된 숙소 정보를 온다에 업데이트합니다. 정해진 시간에 맞춰 Sync를 진행하기 때문에 업데이트가 즉시 반영되지 않습니다.
Push : 공급사가 온다를 호출
- 공급사에서 숙소 정보를 변경할 때마다 온다로 변경된 정보를 보내줍니다.
- 숙소/객실 및 요금제의 콘텐츠 정보에 비해 상대적으로 변경 빈도가 잦은 숙소/객실 및 요금제의 상태와 재고/요금/영업일은 Push 방식을 함께 연동하는 것을 권장드립니다.
Sync
정해진 시간마다 온다가 공급사를 호출해 주기적으로 Sync를 진행합니다.
주기는 협의를 통해 결정합니다. 예) 일 1회 새벽 5시, 매 시간 30분 마다 등
파라미터의 lastdate를 기준으로 기존 정보와 비교해 변경된 정보만 응답합니다.
정보 변경 판단 field
- 상태 정보 : "status"
- 콘텐츠 정보 : "status"이외의 모든 값
- 재고/요금 정보: 모든 값
- (영업일 정보 : Push 방식만 사용합니다.)
변경 된 숙소 / 객실 및 요금제 상태 & 콘텐츠 불러오기
| API | Method | 설명 |
|---|---|---|
| Get Updated Property List | GET | 변경된 숙소 목록 조회 |
| Get Updated Roomtype List | GET | 변경된 객실 및 요금제 목록 조회 |
변경 된 재고 / 요금 / 영업일 불러오기
| API | Method | 설명 |
|---|---|---|
| Get Updated Avails | GET | 변경된 재고 정보 조회 |
| Get Updated Rates | GET | 변경된 요금 정보 조회 |
Push
공급사에서 숙소 정보를 변경할 때마다 온다로 변경된 정보를 즉시 Push합니다. *콘텐츠는 Push 방식을 지원하지 않습니다.
동기화 시점까지 기다리지 않고 변경된 정보를 온다에 반영할 수 있습니다.
Push 방식을 연동할 경우 Sync 방식보다 예약 실패 발생률을 낮출 수 있습니다.
변경 된 숙소 / 객실 / 요금제 상태 전송
참고 사항
숙소 / 객실 / 요금제가 비활성화 혹은 삭제된 경우 응답 값의 status 항목을 모두 disabled로 응답해주세요.
| API | Method | 설명 |
|---|---|---|
| Update Property Status | PATCH | 숙소 상태 변경 전송 |
| Update Roomtype Status | PATCH | 객실 상태 변경 전송 |
| Update Rateplan Status | PATCH | 요금제 상태 변경 전송 |
변경 된 재고 / 요금 / 영업일 전송
| API | Method | 설명 |
|---|---|---|
| Push Setting Avails | POST | 재고 정보 전송 |
| Push Setting Rates | POST | 요금 정보 전송 |
| Push Setting Business-days | POST | 영업일 정보 전송 |