1. 内容API
Locals 路客酒店开放接口
  • 预订API
    • 订单创建
      POST
    • 订单取消
      POST
    • 查询订单
      GET
  • 可用性API
    • 报价信息
      GET
  • 内容API
    • 酒店列表
      GET
    • 酒店详情
      GET
  • 数据模型
    • 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
  1. 内容API

酒店列表

测试环境
https://hudson-dev.localhome.cn
测试环境
https://hudson-dev.localhome.cn
GET
/openapi/hotel/
调用方式(HTTP Method):GET
调用路客 OpenAPI 的所有接口时,必须包含以下5个请求头(其他接口不再赘述):
1.
Content-Type = application/json
2.
Accept-Encoding = gzip, deflate, br
3.
Timestamp = 参与签名运算的UTC时间戳,每次请求请生成新的时间戳,示例值:1758721178145
4.
PartnerId = 路客提供的合作伙伴id,路客 OpenAPI 将根据 PartnerId 获取对应的 secret 以便签名校验,示例值:123456
5.
Authorization = "Bearer " + sign,示例值:Bearer vr1k3uG1L1rlTYxhRbvOuPXVS3E=
其中 sign 为请求签名,生成签名的方法如下:
拼接待签名字符串 = "[" + timestamp + "] " + method + " " + url
secret 作为密钥使用 HMAC-SHA1 对待签名字符串加密,然后对加密结果 Base64 编码得到请求签名 sign
上述 secret 为路客提供的接口密钥,注意,不要在接口请求头或参数中传递您的secret,请保管好您的密钥并仅在您的后端代码中使用它

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://hudson-dev.localhome.cn/openapi/hotel/?skip=0&limit=50' \
--header 'Authorization: {{authorization}}' \
--header 'Timestamp: {{timestamp}}' \
--header 'PartnerId: 1758852059833961'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "success": false,
  "code": "",
  "message": "",
  "data": [
    {
      "hotelId": 0,
      "nation": "",
      "state": "",
      "city": "",
      "name": "",
      "nameCn": "",
      "address": "",
      "tel": "",
      "zip": "",
      "gisType": "",
      "lng": 0.0,
      "lat": 0.0
    }
  ]
}
修改于 2026-06-21 13:22:12
上一页
报价信息
下一页
酒店详情
Built with