价格确认

约 671 字大约 2 分钟

2026-03-27

POST 价格确认

此 API 用于获取房型级别的实时报价（验价接口）。

在创建订单前需要调用此接口，用于二次确认价格。

接口地址

POST /rate/PriceConfirm?$format=json

请求参数说明

{
  "PreBook": true,
  "CheckInDate": "2025-12-22",
  "CheckOutDate": "2025-12-23",
  "HotelID": 1080044,
  "NumOfRooms": 1,
  "OccupancyDetails": [
    {
      "RoomNum": 1,
      "AdultCount": 1,
      "ChildCount": 1,
      "ChildAgeDetails": [0]
    }
  ],
  "Currency": "USD",
  "Nationality": "HK",
  "RatePlanID": "574308669677820045"
}

PreBook 说明

值	说明
true	返回 ReferenceNo（下单必须）
false	仅验价，性能更好

属性	类型	必填	说明
HotelID	number	是	酒店ID
CheckInDate	DateTime	是	入住日期
CheckOutDate	DateTime	是	离店日期
Nationality	String	否	国家代码（默认 CN）
NumOfRooms	number	是	房间数
OccupancyDetails	List	是	入住信息
PreBook	boolean	是	是否预订
Currency	String	是	币种
Metadata	String	否	扩展字段
RatePlanID	String	是	房价计划ID（来自Search）

OccupancyDetails 说明

属性	类型	必填	说明
RoomNum	number	是	房间序号（从1开始）
AdultCount	number	是	成人数
ChildCount	number	是	儿童数
ChildAgeDetails	List	否	儿童年龄

请求示例

curl --location --request POST '{{domain}}/rate/PriceConfirm?$format=json' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "PreBook":true,
  "CheckInDate":"2025-12-22",
  "CheckOutDate":"2025-12-23",
  "HotelID":1080044,
  "NumOfRooms":1,
  "OccupancyDetails":[
    {
      "RoomNum":1,
      "AdultCount":1,
      "ChildCount":1,
      "ChildAgeDetails":[0]
    }
  ],
  "Currency":"USD",
  "Nationality":"HK",
  "RatePlanID":"574308669677820045"
}'

返回示例

{
  "Success": {
    "PriceDetails": {
      "ReferenceNo": "15442173799",
      "CheckInDate": "2025-12-22 00:00:00",
      "CheckOutDate": "2025-12-23 00:00:00",
      "HotelList": [
        {
          "HotelID": 1080044,
          "HotelName": "贵族酒店 - 贝斯特韦斯特辛尼雀精选系列",
          "Destination": {
            "CityCode": "178305"
          },
          "TotalPrice": 154,
          "RatePlanList": [
            {
              "RoomOccupancy": {
                "RoomNum": 1,
                "AdultCount": 1,
                "ChildCount": 1,
                "ChildAgeDetails": [0]
              },
              "RoomTypeID": 4673056,
              "RatePlanID": "574308669677820045",
              "RatePlanName": "1 King Bed...",
              "Currency": "USD",
              "TotalPrice": 154,
              "PriceList": [
                {
                  "Price": 154,
                  "StayDate": "2025-12-22 00:00:00"
                }
              ]
            }
          ],
          "CancellationPolicyList": [
            {
              "LocalFromDate": "2026-03-24T23:00:00+07:00",
              "Amount": 154
            }
          ]
        }
      ]
    }
  }
}

返回参数说明

属性	类型	必填	说明
PriceDetails	Object	是	价格详情
ReferenceNo	String	否	订单参考号（PreBook=true返回）
CheckInDate	DateTime	是	入住日期
CheckOutDate	DateTime	是	离店日期
HotelList	List	是	酒店列表

HotelList 说明

属性	类型	必填	说明
HotelID	number	是	酒店ID
HotelName	String	是	酒店名称
Destination	Object	否	目的地
TotalPrice	Decimal	是	总价
RatePlanList	List	是	房价列表
CancellationPolicyList	List	否	取消政策

RatePlanList 说明（核心）

属性	类型	必填	说明
RoomOccupancy	Object	是	入住信息
RoomTypeID	number	否	房型ID
RoomName	String	否	房型名称
RatePlanID	String	是	房价ID
RatePlanName	String	是	房价名称
BedType	number	否	床型
Currency	String	是	币种
TotalPrice	Decimal	是	房间总价
PriceList	List	是	每日价格
MealType	number	推荐	餐型
MealAmount	number	推荐	餐食份数

PriceList 说明

属性	类型	必填	说明
Price	Decimal	是	每日价格
StayDate	DateTime	是	日期
MealType	number	否	餐型
MealAmount	number	否	餐食份数

取消政策说明

属性	类型	必填	说明
LocalFromDate	String	否	当地酒店时间
Amount	Decimal	否	罚金