- 预订API
- 可用性API
- 内容API
- 数据模型
- Data
- BedType
- ReserveRes
- Hotel
- RoomBed
- BoundingPolygon
- ManageOrderRes
- CheckDays
- HotelRes
- Customer
- Meal
- CoordinatesRegion
- ManageOrderRQ
- HudsonCustomer
- RoomCustomer
- DailyInfo
- BreakfastPolicy
- MapListString
- HudsonCustomerInfo
- DailyPrice
- Fee
- Image
- Ancestors
- ContactInfo
- Gift
- Region
- RefundRule
- NationRule
- Room
- ContactInfo
- HotelDetail
- NightCharge
- CarRentalInfo
- HotelDetailRes
- Stay
- FlightInfo
- Amount
- CruiseInfo
- Charge
- TrainTicketInfo
- Breakfast
- Totals
- StdReserveRQ
- DayInfo
- ChargeCalculated
- key
- Data
- ExtraFee
- FeesPricingInformation
- CancelRes
- GiftService
- EpsPriceInfo
- Localized
- CancelRQ
- Rate
- Address
- GoodsRoom
- HotelRate
- PropertyRating
- MapString
- key
- GuestRating
- MapHotelGoods
- AvailabilityRes
- Ratings
- Data
- Coordinates
- Location
- StdPricesRQ
- CategoryProperty
- BusinessModel
- Data
- Checkin
- Checkout
- Fees
- Policies
- key
- MapAttribute
- key
- Attributes
- key
- MapAmenity
- key
- MapLink
- key
- MapPaymentType
- OnsitePayments
- DescriptionsRoom
- key
- key
- BedGroupConfiguration
- key
- MapBedGroup
- Area
- key
- MapView
- MaxAllowed
- key
- MapCategoryAge
- Occupancy
- key
- MapRoomContent
- key
- key
- MapRateContent
- Dates
- Descriptions
- key
- MapStatistic
- Preferred
- AssociatedAirports
- key
- MapTheme
- AllInclusive
- key
- MapBrand
- Chain
- Brand
- key
- Link
- PropertyManagerLinks
- PropertyManager
- RentalAgreementLinks
- RentalAgreement
- key
- Amenity
- key
- VacationRentalDetails
- key
- ContentRequest
- PropertyInactive
- InactiveRequest
- Review
- GuestReviewsVerified
- GuestReviews
- RestResponseGuestReviews
- ContentGuestReviewRequest
- RestResponseLink
- ContentCatalogRequest
- MapAmenityReference
- RestResponseMapAmenityReference
- ContentPublicRequest
- key
- MapChain
- MapAttributeReference
- RestResponseMapAttributeReference
- MapImageReference
- RestResponseMapImageReference
- RestResponseMapPaymentType
- RestResponseMapView
- RestResponseMapSpokenLanguage
- MapStatisticReference
- RestResponseMapStatisticReference
- RestResponseMapTheme
- SaleScenario
- key
- GetPaymentOptionsOperationLink
- RateLinks
- BedGroupAvailabilityLinks
- key
- MapBedGroupAvailability
- CancelPenalty
- NonrefundableDateRange
- MarketingFeeIncentive
- MarketingFeeDetails
- key
- MapPricingInformation
- key
- MapValueAdd
- Deal
- Promotions
- Deposit
- RoomAvailability
- GetAdditionalAvailabilityOperationLink
- GetAvailabilityOperationLink
- PropertyAvailabilityLinks
- MapListPropertyAvailability
- RestResponseMapListPropertyAvailability
- AvailabilityRequest
- key
- PriceCheckOperationLink
- key
- key
- key
- PropertyAvailability
- RestResponseListPropertyAvailability
- AdditionalAvailabilityRequest
- key
- PostItineraryOperationLink
- CommitChangeOperationLink
- PostPaymentSessionsOperationLink
- RoomPriceCheckLinks
- TraderAddress
- TraderDetailsInner
- TraderInformation
- RoomPriceCheck
- RestResponseRoomPriceCheck
- PriceCheckRequest
- AffiliateCollect
- CardOption
- CreditCardMerchant
- CreditCard
- PaymentOption
- RestResponsePaymentOption
- StayConstraints
- Day
- PropertyCalendarAvailability
- RestResponseListPropertyCalendarAvailability
- CalendarsAvailabilityRequest
- PaymentSessionsLinks
- PaymentSessions
- RestResponsePaymentSessions
- CustomerAccountDetails
- Address
- BillingContact
- ThirdPartyAuthentication
- TotalChargesAllowed
- Phone
- CardContact
- AdditionalHandling
- Payment
- PaymentSessionsRequest
- GetReservationByItineraryIdOperationLink
- PutResumeBookingOperationLink
- PutCompletePaymentSessionOperationLink
- DeleteHeldBookingOperationLink
- ItineraryCreationLinks
- ItineraryCreation
- RestResponseItineraryCreation
- Phone
- Loyalty
- CompanyAddress
- Invoicing
- SupplierTransparency
- CreateBookRequest
- Nothing
- EmptyResponse
- RestResponseEmptyResponse
- ResumeBookRequest
- CompletePaymentSessionLinks
- CompletePaymentSession
- RestResponseCompletePaymentSession
- ItineraryLinks
- Phone
- ConfirmationId
- Loyalty
- CancelRefund
- key
- PromotionsItinerary
- DepositItinerary
- PricingInformation
- RateItinerary
- DeleteRoomOperationLink
- ChangeRoomDetailsOperationLink
- RoomItineraryLinks
- RoomItinerary
- Address1
- BillingContact
- Adjustment
- key
- Conversations
- SupplyContact
- Image1
- Essential
- EssentialInformation
- SupplierTransparency
- AdditionalHandlingCardContact
- AdditionalHandling
- Invoicing
- ItineraryHistoryItem
- key
- RateHistory
- RoomHistoryItem
- Itinerary
- RestResponseListItinerary
- SearchBookRequest
- key
- key
- key
- RestResponseItinerary
- SearchBookBySupplierOrderIdRequest
- CancelHeldBookRequest
- InputStream
- ResponseInputStream
- RestResponseResponseInputStream
- BookReceiptRequest
- ChangeRoomDetailsRequest
- ChangeItineraryRequest
- CampaignsRequest
- SearchPromotionRequest
- RestResponseString
报价信息
测试环境
https://hudson-dev.localhome.cn
测试环境
https://hudson-dev.localhome.cn
GET
/openapi/hotel/availability
1.至少仅需要 hotelIds 和 checkin、checkout 参数，通常还需要填写 roomNum、roomCustomers 参数； 2.一次查询 hotelIds 最多5个，checkin、checkout 最多30天，roomNum 默认 1，roomCustomers 默认 2 成人 0 儿童； 3.仅返回酒店下房型的符合查询条件的报价，不满足连住、间数、提前预订等约束，或查询日期范围内整体不可订的，将被过滤不返回。
1.报价校验场景，请仅传确定的一个 hotelIds 和 ratePlanId，以及实际的 checkin、checkout、roomNum、roomCustomers 参数； 2.另外，还需提供待下单金额相关的 dailyPrices、taxAndFee 参数，currency 请与查询报价结果保持一致，将检查待下单金额能否成功预订。
请求参数
Query 参数
Header 参数
请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://hudson-dev.localhome.cn/openapi/hotel/availability?rq={%22hotelIds%22%3A%221296369727399878657%2C1296369727399878658%22%2C%22checkin%22%3A%222024-01-01%22%2C%22checkout%22%3A%222024-01-03%22%2C%22roomNum%22%3A1%2C%22roomCustomers%22%3A[{%22adults%22%3A2}]}' \
--header 'Authorization: {{authorization}}' \
--header 'Timestamp: {{timestamp}}' \
--header 'PartnerId: 1758852059833961'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"success": true,
"code": "SUCCESS",
"message": "EnumErrorCode.SUCCESS.getDesc()",
"data": [
{
"hotelId": 1296369727399878700,
"name": "Hilton Motif Seattle",
"nameCn": "西雅图希尔顿酒店",
"currency": "CNY",
"timeZone": "GMT+8",
"rates": [
{
"roomId": 0,
"name": "City View Deluxe Family Suite",
"nameCn": "City View Deluxe Family Suite",
"ratePlanId": 1296369727399878700,
"view": "NONE",
"roomBed": [
{
"relation": "AND",
"beds": [
{
"type": "KING_BED",
"count": 1
}
]
}
],
"breakfast": {
"count": 0,
"desc": "早餐",
"desc2": "双早"
},
"checkinTime": "12:00",
"checkoutTime": "14:00",
"dailyInfos": [
{
"date": "2030-01-10",
"price": 500,
"status": 1,
"count": 1
}
],
"taxAndFee": 15,
"adults": 2,
"children": 0,
"childAge": 12,
"checkinFees": [
{
"name": "城市税",
"fee": 15,
"currency": "CNY"
}
],
"gifts": [
{
"type": "OTHER",
"name": "欢迎果盘",
"desc": "入住日22:00前到店，免费赠送欢迎果盘一份",
"price": 120,
"rule": "ONCE"
}
],
"refundRules": [
{
"type": "FREE",
"amount": 0,
"maxHoursBeforeCheckIn": 0,
"minHoursBeforeCheckIn": 0,
"currency": "CNY",
"zone": "GMT+08:00"
}
],
"originalCancellationPolicy": "string",
"cancellationExchangeRate": 0,
"nationRule": {
"type": "WRITE_LIST",
"nations": [
"string"
]
},
"roomExtJson": "string",
"pricingInformation": [
{
"rpId": 0,
"rateScore": 0,
"exchangeRate": 0,
"nightly": [
[
{
"type": "BASE_RATE",
"value": "string",
"currency": "string"
}
]
],
"stay": [
{
"type": "BASE_RATE",
"value": "string",
"currency": "string"
}
],
"totals": {
"inclusive": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"exclusive": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"propertyInclusive": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"inclusiveStrikethrough": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"strikethrough": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"propertyInclusiveStrikethrough": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"marketingFee": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"grossProfit": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"minimumSellingPrice": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"propertyFees": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
}
},
"fees": {
"mandatoryFee": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"resortFee": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
},
"mandatoryTax": {
"billableCurrency": {
"value": "string",
"currency": "string"
},
"requestCurrency": {
"value": "string",
"currency": "string"
}
}
}
}
],
"isPackagingPrice": 0,
"cancelStatus": "string",
"unCancelDates": "string",
"specialOfferDescription": "string",
"valueAddPromotion": [
"string"
],
"rateAmenity": [
"string"
]
}
]
}
],
"extras": {
"key": "string"
}
}修改于 2026-06-21 13:22:42