Locals 路客酒店开放接口
  1. 内容API
Locals 路客酒店开放接口
  • 预订API
    • 订单创建
      POST
    • 订单取消
      POST
    • 查询订单
      GET
  • 可用性API
    • 报价信息
      GET
  • 内容API
    • 酒店列表
      GET
    • 酒店详情
      GET
  • 数据模型
    • Data
    • ReserveRes
    • CheckDays
    • Customer
    • HudsonCustomer
    • RoomCustomer
    • HudsonCustomerInfo
    • DailyPrice
    • MapBigDecimal
    • ContactInfo
    • MapString
    • StdReserveRQ
    • Data
    • CancelRes
    • CancelRQ
    • BedType
    • Breakfast
    • RoomBed
    • DayInfo
    • Meal
    • ExtraFee
    • DailyInfo
    • GiftService
    • Fee
    • RefundRule
    • Gift
    • GoodsRoom
    • Rate
    • key
    • HotelRate
    • NationRule
    • MapHotelGoods
    • Data
    • AvailabilityRes
    • StdPricesRQ
    • Hotel
    • Data
    • HotelRes
    • BreakfastPolicy
    • Image
    • Room
    • HotelDetail
    • HotelDetailRes
  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 --request GET 'https://hudson-dev.localhome.cn/openapi/hotel/?skip=0&limit=50' \
--header 'Authorization: {{authorization}}' \
--header 'Timestamp: {{timestamp}}' \
--header 'PartnerId: 1758852059833961'

返回响应

🟢200成功
application/json
Body

示例
{
  "success": false,
  "code": "",
  "message": "",
  "data": [
    {
      "hotelId": 0,
      "nation": "",
      "state": "",
      "city": "",
      "name": "",
      "nameCn": "",
      "address": "",
      "tel": "",
      "zip": "",
      "gisType": "",
      "lng": 0.0,
      "lat": 0.0
    }
  ]
}
修改于 2025-10-14 03:28:32
上一页
报价信息
下一页
酒店详情
Built with