预定

约 498 字大约 2 分钟

POST 预订酒店

POST /v1.0/booking

请求参数

{
  "bookingReferenceId": "86621248",
  "hotel": "5931939",
  "roomCode": "R848281",
  "checkIn": "2023-10-10",
  "checkOut": "2023-10-11",
  "quantity": 1,
  "guest": {
    "phone": "12345678123",
    "email": "eric.li@phoentrix.com",
    "guestName": [
      {
        "firstName": "Liang",
        "lastName": "Li"
      }
    ]
  },
  "occupancy": {
    "adults": 1,
    "childrenAges": []
  },
  "ratePlanCode": "DBDAEE3618140F99B14A0103EE9B7EFDC55D75B3AE7D43564B422264602FE456A7796F6D4F86C670052FB57D22823AF9",
  "totalPrice": 28.82,
  "currency": "USD",
  "nation": "CN",
  "channel": 1,
  "boardCode": "RO",
  "bedGroupId": "37336",
  "specialRequests": "",
  "hotelPackage": ""
}

属性	类型	必填	说明
bookingReferenceId	string	必填	客户订单编号
hotel	string	必填	酒店id
roomCode	string	必填	房型编号
checkIn	string	必填	入住日期
checkOut	string	必填	离店日期
quantity	int	必填	房间数
guest	object	必填	联系人信息
phone	string	必填	联系人电话信息
email	string	必填	联系人邮箱信息
guestName	List	必填	入住人列表
firstName	string	必填	入住人名字
lastName	string	必填	入住人姓氏
occupancy	object	必填	入住信息
adults	int	必填	成人人数
childrenAges	List	非必填	小孩年龄
ratePlanCode	string	必填	售卖计划编号
totalPrice	decimal	必填	总价
currency	string	非必填	货币单位
nation	string	非必填	国籍代码
channel	int	非必填	渠道，暂时默认值1
boardCode	string	必填	餐卷编号
bedGroupId	string	非必填	床型编号
specialRequests	string	非必填	特殊要求信息
hotelPackage	string	非必填	酒店打包价，打包价：hotel_package

请求示例

curl --location --request POST '{{domain}}/v1.0/booking' \
--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 '{
    "bookingReferenceId":"86621248",
    "hotel":"5931939",
    "roomCode":"R848281",
    "checkIn":"2023-10-10",
    "checkOut":"2023-10-11",
    "quantity":config.js,
    "guest":{
        "phone":"12345678123",
        "email":"eric.li@phoentrix.com",
        "guestName":[
            {
                "firstName":"Liang",
                "lastName":"Li"
            }
        ]
    },
    "occupancy":{
        "adults":config.js,
        "childrenAges":[

        ]
    },
    "ratePlanCode":"DBDAEE3618140F99B14A0103EE9B7EFDC55D75B3AE7D43564B422264602FE456A7796F6D4F86C670052FB57D22823AF9",
    "totalPrice":28.82,
    "currency":"USD",
    "nation":"CN",
    "channel":config.js,
    "boardCode":"RO",
    "bedGroupId":"37336",
    "specialRequests":"",
    "hotelPackage":""
}'

返回示例

{
  "responseStatus": "SUCCESS",
  "version": "v1.0",
  "referenceId": "230602279",
  "bookingReferenceId": "86621248",
  "remark": "booking successful"
}

属性	类型	必填	说明
responseStatus	string	必填	状态
version	string	必填	版本号
referenceId	string	非必填	纷客行订单号
bookingReferenceId	string	必填	客户订单号
remark	string	非必填	备注

状态码

编码	说明
SUCCESS	成功
BOOKING_FAIL	订单失败
BOOKING_TIMEOUT	订单超时
UNAUTHORIZED	认证校验失败
SUPPLIER_SERVER_ERROR	系统或接口异常