搜索

约 869 字大约 3 分钟

POST 搜索酒店

POST /v1.0/search

请求参数

{
  "hotels": ["5931939"],
  "checkIn": "2023-07-04",
  "checkOut": "2023-07-05",
  "occupancy": {
    "rooms": 1,
    "adults": 1,
    "childrenAges": []
  },
  "currency": "",
  "hotelPackage": "",
  "language": "zh-cn",
  "countryCodes": ["CN"]
}

属性	类型	必填	说明
hotels	List	必填	酒店id 集合
checkIn	string	必填	入住日期
checkOut	string	必填	离店日期
occupancy	object	必填	入住信息
rooms	int	必填	房间数
adults	int	必填	成人人数
childrenAges	List	非必填	小孩年龄
countryCodes	List	非必填	国籍代码
currency	string	非必填	货币单位
language	string	非必填	语言
hotelPackage	string	非必填	酒店打包价

请求示例

curl --location --request POST '{{domain}}/v1.0/search' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--data-raw '{
  "hotels": [
    "5931939"
  ],
  "checkIn": "2023-07-04",
  "checkOut": "2023-07-05",
  "occupancy": {
    "rooms": config.js,
    "adults": config.js,
    "childrenAges": []
  },
  "currency": "",
  "hotelPackage": "",
  "language": "zh-cn",
  "countryCodes": [
    "CN"
  ]
}'

返回示例

{
  "responseStatus": "SUCCESS",
  "version": "v1.0",
  "checkIn": "2023-07-04",
  "checkOut": "2023-07-05",
  "hotels": [
    {
      "code": "5931939",
      "name": "Beston Pattaya",
      "rooms": [
        {
          "code": "25238354",
          "name": "Deluxe Triple Room",
          "rates": [
            {
              "id": "201654214",
              "name": "Deluxe Triple room",
              "boardCode": "RO",
              "ratePlanCode": "DBDAEE3618140F99B14A0103EE9B7EFDC55D75B3AE7D4356F273519600205CB662FEC17BB258EEBF3A20457A03E17F2B",
              "channel": 1,
              "allotment": 5,
              "currency": "USD",
              "price": 33.8,
              "priceRSP": 33.8,
              "dailyPrices": [
                {
                  "date": "2023-07-04",
                  "price": 33.8,
                  "priceRSP": 33.8,
                  "currency": "USD",
                  "taxes": [
                    {
                      "type": "tax_and_service_fee",
                      "value": 5.54,
                      "currency": "USD"
                    },
                    {
                      "type": "base_rate",
                      "value": 28.26,
                      "currency": "USD"
                    }
                  ]
                }
              ],
              "taxes": [],
              "adult": 1,
              "childAges": [],
              "bedtypeName": "37326",
              "cancellationPolicy": null,
              "cancel_penalties": [
                {
                  "start": "2023-05-24T03:00:00.000+07:00",
                  "end": "2023-07-04T18:00:00.000+07:00",
                  "amount": null,
                  "nights": null,
                  "percent": "100%",
                  "currency": "USD"
                }
              ],
              "extendProperty": "{\"fees\":\"null\",\"bed_groups\":\"[{\\\"id\\\":\\\"37326\\\",\\\"description\\\":\\\"3 张单人床\\\"}]\",\"hotelPackage\":\"hotel_only\",\"mealList\":\"[]\"}"
            }
          ]
        }
      ]
    }
  ],
  "remark": null
}

属性	类型	必填	说明
responseStatus	string	必填	状态
version	string	必填	版本号
remark	string	非必填	备注
checkIn	string	必填	入住日期
checkOut	string	必填	离店日期
hotels	List	必填	酒店价格集合
code	string	必填	酒店编号
name	string	必填	酒店名称
rooms	list	必填	房型列表
code	string	必填	房型编号
name	string	必填	房型名称
rates	List	必填	售卖价格列表
id	string	非必填	房型编号
name	string	必填	房型名称
boardCode	string	必填	餐卷编号
ratePlanCode	string	必填	售卖价格编号
channel	string	必填	面纱，默认值1, 1=裸卖 23=面纱
allotment	int	必填	可预订的房间总数暂时为固定值5
currency	string	必填	货币单位
price	decimal	必填	多天总价
priceRSP	decimal	必填	多天RSP总价
dailyPrices	List	必填	每天价格列表
date	string	必填	每天日期
price	decimal	必填	每天价格
priceRSP	decimal	必填	每天RSP价格
currency	string	必填	货币单位
taxes	List	非必填	每天税费价格列表
type	string	必填	税费类型
value	decimal	必填	税费价格
currency	string	必填	货币单位
taxes	List	非必填	税费价格列表
type	string	必填	税费类型
value	decimal	必填	税费价格
currency	string	必填	货币单位
adult	int	必填	成人人数
childAges	List	非必填	小孩年龄列表
bedtypeName	string	非必填	床型编号
cancellationPolicy	object	非必填	取消政策
policies	List	必填	取消政策列表
amount	decimal	必填	取消罚金
daysBeforeCheckIn	int	必填	入住前多少天可取消
cancel_penalties	List	非必填	原取消政策列表
start	string	必填	开始时间
end	string	必填	结束时间
amount	decimal	非必填	取消罚金
nights	string	非必填	晚数
percent	百分比	非必填	扣款百分比
currency	string	必填	货币单位
extendProperty	string	非必填	扩展字段：fees节点到店费用，bed_groups节点床型列表，mealList节点餐卷列表，hotelPackage节点价格种类（零售或打包）

状态码

编码	说明
SUCCESS	成功
NO_AVAILABILITY	没有可用性
UNAUTHORIZED	认证校验失败
SUPPLIER_SERVER_ERROR	系统或接口异常