酒店接口文档-磐河旅行开放平台

接口地址： http://接口域名/hotel/searchHotelList

返回格式： json

请求方法： get/post

请求示例： http://接口域名/hotel/searchHotelList?appKey=您申请的APPKEY&cityName=常州&checkInDate=2020-07-27&checkOutDate=2020-07-29&queryText=如家&pageIndex=1&pageSize=10

接口说明：

用于酒店搜索列表页

请求参数：

参数名称	类型	必填	说明
cityName	string	是	和cityCode必填一个,城市名称（城市数据字典请联系平台提供，PS:所有城市都是地级行政区（包括地级市、地区、自治州、盟）和直辖市，如需检索县级行政区（包括市辖区、县级市、县、自治县）请用districtName字段检索（如：cityName=苏州 & districtName =昆山），cityName请勿传入县级行政区（比如昆山市、嘉善县）系统会提示无效城市名。）
cityCode	string	是	和cityName必填一个,城市code（cityCode和cityName不能同时为空，同时传入时以cityCode为准）
checkInDate	string	是	必填,入住日期（格式：yyyy-MM-dd）
checkOutDate	string	是	必填,离店日期（格式：yyyy-MM-dd）
pageIndex	int	是	必填,页码（从1开始）
pageSize	int	是	必填,每页请求酒店数量（取值范围：1-20，默认为10）
queryText	string	否	查询关键词全文检索，可以是酒店名、位置或品牌等。
hotelStars	string	否	酒店星级(两星及以下=2 , 三星级=3 ,四星级=4 , 五星级=5 ),同时搜索多个星级时以英文逗号分隔
minPrice	int	否	价格范围，最小价格，不限制传null即可
maxPrice	int	否	价格范围，最大价格，不限制传null即可
longitude	double	否	经度（经纬度必须同时传值才有效），默认为null （谷歌地图）
latitude	double	否	纬度（经纬度必须同时传值才有效），默认为null （谷歌地图）
range	int	否	当传入经纬度查询附近酒店时返回方圆多少公里以内的酒店(单位KM，不传或传0时默认为：100KM)
districtName	string	否	行政区名称
brands	string	否	酒店品牌，多个品牌用英文逗号分隔（如：汉庭,7天）
sort	int	否	排序类型：默认排序=0，价格升序=1,价格降序=2，评分降序=3，距离升序=4（PS:当没传经纬度位置值时，默认排序就是评分降序，即此时0和3值等效，此时距离排序=4 值无效；当传了经纬度位置值时默认排序就是距离升序，即此时0和4值等效。）

返回参数：

参数名称	类型	说明
count	int	查询到的酒店数量
hotelList	hotelBriefInfo[]	酒店列表
hotelID	int	酒店ID
hotelName	string	酒店名称
cityName	string	城市名称
address	string	酒店地址
hotelStar	int	酒店星级(无星级=0 ,一星级=1 ,二星级=2 , 三星级=3 ,四星级=4 , 五星级=5 ,经济型=6 , 舒适型=7 ,高档型=8 ,豪华型=9)
isGovStar	bool	是否挂牌星级：true：是挂牌星级 , false：否 , 空表示未知/不确定
hotelStarName	string	星级显示名称
avgScore	float	酒店评分，5分制
googleLat	double	经度（谷歌地图）
googleLon	double	纬度（谷歌地图）
distance	int	当传入经纬度时，返回与酒店的直线距离,单位是米。距离是根据请求参数传入的经纬度和酒店的经纬度两个点计算出来的，有点误差是正常的，误差基本小于50m
mainImage	string	主图
startingPrice	float	起价（可能为空，即暂未报价）
lstServiceFacilities	string[]	服务设施列表，列表页最多返回前4个展示

JSON返回示例 :

{
  "data": {
    "count": 14,
    "hotelList": [
      {
        "hotelID": 2244298,
        "hotelName": "如家睿柏·云酒店(天长天康大道店)",
        "cityName": "滁州",
        "address": "天康大道凤鸣小区",
        "hotelStar": 7,
        "avgScore": null,
        "googleLat": 32.673551,
        "googleLon": 119.009952,
        "mainImage": "http://m.tuniucdn.com/fb2/t1/G6/M00/28/69/Cii-U13PygyILTLbAAFrR7AduVkAAElkwCqCi8AAWtf996.jpg",
        "startingPrice": 134.0
      },
      {
        "hotelID": 1981341594,
        "hotelName": "如家精选酒店(天长市政府天发广场店)",
        "cityName": "滁州",
        "address": "千禧佳福商业街1号楼1-4层",
        "hotelStar": 7,
        "avgScore": null,
        "googleLat": 32.666885,
        "googleLon": 118.999736,
        "mainImage": "http://m.tuniucdn.com/fb3/s1/2n9c/2yg7zfpzmRLrz8H7Lgw83yicwn2p.jpg",
        "startingPrice": 189.0
      },
      {
        "hotelID": 6316749,
        "hotelName": "如家酒店(天长天发广场店)",
        "cityName": "滁州",
        "address": "天康大道天发广场9号楼",
        "hotelStar": 6,
        "avgScore": null,
        "googleLat": 32.678024,
        "googleLon": 119.00043,
        "mainImage": "http://m.tuniucdn.com/fb2/t1/G6/M00/28/69/Cii-TF3Pyg2IAXC4AATYL44tDYoAAElkwEw5DwABNhH718.jpg",
        "startingPrice": 135.0
      },
      {
        "hotelID": 200520760,
        "hotelName": "如家商旅酒店(滁州天长路步行街店)",
        "cityName": "滁州",
        "address": "天长东路136号",
        "hotelStar": 7,
        "avgScore": null,
        "googleLat": 32.305542,
        "googleLon": 118.317058,
        "mainImage": "http://m.tuniucdn.com/fb3/s1/2n9c/3r9j2WSL6Xz5w37tTrfuijZfb7Uo.jpg",
        "startingPrice": 154.0
      },
      {
        "hotelID": 586217,
        "hotelName": "如家酒店(明光明珠大道店)",
        "cityName": "滁州",
        "address": "明珠大道77号",
        "hotelStar": 6,
        "avgScore": null,
        "googleLat": 32.781206,
        "googleLon": 118.00892,
        "mainImage": "http://m.tuniucdn.com/filebroker/cdn/res/7f/b1/7fb186384699766ece1c1acb8cdd0b39.jpg",
        "startingPrice": 172.0
      },
      {
        "hotelID": 200525149,
        "hotelName": "滁州如家宾馆",
        "cityName": "滁州",
        "address": "南谯南路668号",
        "hotelStar": 6,
        "avgScore": null,
        "googleLat": 32.284997,
        "googleLon": 118.322159,
        "mainImage": "http://m.tuniucdn.com/fb2/t1/G2/M00/F1/2B/Cii-TFk3S-yIE98yAAHJZ9f4ENAAALeOAJlwAUAAcl_008.jpg",
        "startingPrice": 0.0
      },
      {
        "hotelID": 214875325,
        "hotelName": "滁州荣成如家酒店",
        "cityName": "滁州",
        "address": "来安路65号",
        "hotelStar": 6,
        "avgScore": null,
        "googleLat": 32.306059,
        "googleLon": 118.327708,
        "mainImage": "http://m.tuniucdn.com/fb2/t1/G5/M00/B2/F4/Cii-s12Q8RaIMZ8XAAhK1AwFYFMAAaw_QBy_9YACErs102.jpg",
        "startingPrice": 0.0
      },
      {
        "hotelID": 200524986,
        "hotelName": "滁州乐如家快捷酒店",
        "cityName": "滁州",
        "address": "南谯北路439号",
        "hotelStar": 0,
        "avgScore": null,
        "googleLat": 32.312685,
        "googleLon": 118.309447,
        "mainImage": "http://m.tuniucdn.com/fb2/t1/G5/M00/B2/F4/Cii-s12Q8ROIPQr5AAT4U33lOpcAAaw_AJ4kf8ABPhr964.jpg",
        "startingPrice": 0.0
      },
      {
        "hotelID": 214957370,
        "hotelName": "凤阳美如家快捷宾馆",
        "cityName": "滁州",
        "address": "凤阳汽车站西门对面明帝皇城3楼",
        "hotelStar": 6,
        "avgScore": null,
        "googleLat": 32.871311,
        "googleLon": 117.566097,
        "mainImage": "http://m.tuniucdn.com/fb2/t1/G5/M00/B3/FD/Cii-sl2RjWiIWVrLAAXBpqvkJRkAAa3vgMGNjEABcG-376.jpg",
        "startingPrice": 0.0
      },
      {
        "hotelID": 2049100448,
        "hotelName": "和谐家园温馨如家公寓(明光中心街店)",
        "cityName": "滁州",
        "address": "G104京福线",
        "hotelStar": 0,
        "avgScore": null,
        "googleLat": 32.899424,
        "googleLon": 117.949517,
        "mainImage": "http://m.tuniucdn.com/fb3/s1/2n9c/3dV59qkmCFyVey7PjdqE29ZEHVWS.jpg",
        "startingPrice": 0.0
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/hotel/getHotelDetail

返回格式： json

请求方法： get/post

请求示例： http://接口域名/hotel/getHotelDetail?appKey=您申请的APPKEY&hotelID=372505161

接口说明：

用于酒店详情页中-酒店静态数据部分

请求参数：

参数名称	类型	必填	说明
hotelID	int	是	（必填）酒店ID
checkInDate	string	是	（必填）入住日期（格式：yyyy-MM-dd）
checkOutDate	string	是	（必填）离店日期（格式：yyyy-MM-dd）

返回参数：

参数名称	类型	说明
hotelID	int	酒店ID
hotelName	string	酒店名称
cityName	string	城市名称
address	string	酒店地址
mainImage	string	酒店主图
hotelStar	int	酒店星级(一星/低档=1 ,二星/经济=2 , 三星/舒适=3 ,四星/高档=4 , 五星/豪华=5 )
isGovStar	bool	是否挂牌星级：true：是挂牌星级 , false：否 , 空表示未知/不确定
hotelStarName	string	星级显示名称
phone	string	酒店电话
openDate	string	开业时间
decorationDate	string	装修时间
description	string	酒店介绍描述
avgScore	float	评分
googleLat	double	纬度（谷歌地图）
googleLon	double	经度（谷歌地图）
pictures	HotelPicture[]	酒店图片列表
path	string	图片存储路径
name	string	图片代表位置的描述（如头图，外观，大堂）
services	HotelService[]	酒店服务列表
name	string	服务名称
status	string	服务状态 0=无,1=有,2=不确定,3=部分有
facilities	HotelFacility[]	酒店设施列表
name	string	设施名称
status	string	设施状态 0=无,1=有,2=不确定,3=部分有

JSON返回示例 :

{
  "data": {
    "hotelID": 372505161,
    "hotelName": "滁州港汇喜来登酒店",
    "cityName": null,
    "cityCode": null,
    "areaName": null,
    "areaCode": null,
    "address": "中都大道1599号",
    "hotelStar": 9,
    "phone": "0550-2201888",
    "openDate": "2015",
    "decorationDate": null,
    "description": "滁州港汇喜来登酒店是喜达屋酒店及度假村国际集团旗下的喜来登品牌在滁州市的一家酒店。酒店位于滁州政治、商业和文化中心，毗邻滁州市政府，距离滁州高铁站仅5公里，距离南京也仅40分钟车程。酒店由万基集团投资建设，总投资约6亿元人民币，占地50亩，配有290个车位，总建筑面积6.1万方，共26层，总高度99.35米，是滁州较高的酒店——未来滁州的新地标。",
    "avgScore": null,
    "googleLat": 32.242098,
    "googleLon": 118.332009,
    "pictures": [
      {
        "path": "http://m.tuniucdn.com/fb3/s1/2n9c/Y3cwy3rmCHMeDe7U1ZKfaeFcNuk.jpg",
        "name": "行政套房"
      },
      {
        "path": "http://m.tuniucdn.com/fb3/s1/2n9c/6oebPwjLLWWmPt2dVRBPcKXEpVb.jpg",
        "name": "行政套房"
      },
      {
        "path": "http://m.tuniucdn.com/fb3/s1/2n9c/3dYduEb8VMQzTfaaJiDA3S4kyt5y.jpg",
        "name": "行政酒廊"
      }
    ],
    "services": [
      {
        "name": "24小时前台服务",
        "status": "1"
      },
      {
        "name": "商务服务",
        "status": "1"
      },
      {
        "name": "邮政服务",
        "status": "1"
      },
      {
        "name": "快速办理入住/退房手续",
        "status": "1"
      }
    ],
    "facilities": [
      {
        "name": "残疾人客房",
        "status": "1"
      },
      {
        "name": "大堂吧",
        "status": "1"
      },
      {
        "name": "行政楼层",
        "status": "1"
      },
      {
        "name": "健身室",
        "status": "1"
      },
      {
        "name": "自动取款机",
        "status": "1"
      },
      {
        "name": "餐厅",
        "status": "1"
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/hotel/queryRoomAndRatePlan

返回格式： json

请求方法： get/post

请求示例： http://接口域名/hotel/queryRoomAndRatePlan?appKey=您申请的APPKEY&hotelID=590468&checkInDate=2020-07-27&checkOutDate=2020-07-29

接口说明：

用于酒店详情页中-酒店房型、价格、库存等动态数据部分，由于此接口会实时请求多个上游渠道动态数据，固响应时长会较其他接口慢些，建议使用方在酒店详情页采用异步调用方式，同时前端做好loading效果。

请求参数：

参数名称	类型	必填	说明
hotelID	int	是	（必填）酒店ID
checkInDate	string	是	（必填）入住日期（格式：yyyy-MM-dd）
checkOutDate	string	是	（必填）离店日期（格式：yyyy-MM-dd）

返回参数：

参数名称	类型	说明
rooms	RoomInfo[]	（物理）房型列表
roomId	int	房型ID(已废弃字段，下单使用ratePlanId字段)
roomName	string	房型名称
useableArea	string	可用面积
capacity	string	最大容纳人数
floor	string	房型分布的楼层
bedType	string	床型描述
windowType	string	窗型
pictures	HotelPicture[]	房型图片列表（HotelPicture定义见酒店详情）
facilities	HotelFacility[]	房型设施列表（HotelFacility定义见酒店详情）
ratePlans	RatePlanInfo[]	房型可售产品列表
ratePlanId	string	产品价格ID,该值每次调用都会实时变化，所以每次获取后通过页面传参（而不是在下单时再次调用，因为每次值都不一样）进行最终下单传入。
ratePlanName	string	产品名称
paymentType	int	支付方式 0:预付，1:现付 (目前只有预付一种)
averagePrice	float	平均价格
pricePerDay	string	每日价格，以“\|”分隔，数量需与入住/离店时间对应，如2019-05-20入住，2019-05-22离店，300\|320指第1天300元，第2天320元
stockPerDay	string	库存量（提供参考），房间每天的库存量，与销售指导价对应；以“\|”分隔，如2019-05-20入住，2019-05-22离店，3\|5指第1天剩3间房，第2天剩5间房
confirmType	int	确认类型：0 不支持即时确认 1 支持即时确认
breakfast	string	早餐规则,值如：含有2份免费早餐 \| 不含早餐
cancelRule	CancelRuleInfo	取消规则
name	string	取消名称
type	int	取消政策类型(1不可取销,2限时取消,3收费取消)
desc	string	取消政策描述
freeCancelLatestTime	datetime	可以免费取消的最晚时间(当取消政策类型为：限时取消，才有值)

JSON返回示例 :

{
  "data": {
    "rooms": [
      {
        "roomId": 1935942574,
        "roomName": "漫趣主题房",
        "useableArea": "18㎡",
        "capacity": "2",
        "floor": "4-6层",
        "internetWay": null,
        "bedType": "大床",
        "pictures": [
          {
            "path": "http://m.tuniucdn.com/fb3/s1/2n9c/6uM1sioyKvFyQ31jBE5P9iXPE6H.jpg",
            "name": "漫趣主题房"
          }
        ],
        "facilities": [
          {
            "name": "多种规格电源插座",
            "status": "1"
          },
          {
            "name": "220V电压插座",
            "status": "1"
          },
          {
            "name": "遮光窗帘",
            "status": "1"
          },
          {
            "name": "手动窗帘",
            "status": "1"
          },
          {
            "name": "书桌",
            "status": "1"
          },
          {
            "name": "床具:鸭绒被",
            "status": "1"
          },
          {
            "name": "电子秤",
            "status": "1"
          },
          {
            "name": "衣柜/衣橱",
            "status": "1"
          },
          {
            "name": "房间内高速上网",
            "status": "1"
          },
          {
            "name": "空调",
            "status": "1"
          },
          {
            "name": "电话",
            "status": "1"
          },
          {
            "name": "有线频道",
            "status": "1"
          },
          {
            "name": "液晶电视机",
            "status": "1"
          },
          {
            "name": "电热水壶",
            "status": "1"
          },
          {
            "name": "小冰箱",
            "status": "1"
          },
          {
            "name": "迷你吧",
            "status": "1"
          },
          {
            "name": "24小时热水",
            "status": "1"
          },
          {
            "name": "独立淋浴间",
            "status": "1"
          },
          {
            "name": "吹风机",
            "status": "1"
          },
          {
            "name": "拖鞋",
            "status": "1"
          },
          {
            "name": "浴衣",
            "status": "1"
          },
          {
            "name": "浴室化妆放大镜",
            "status": "1"
          }
        ],
        "ratePlans": [
          {
            "ratePlanId": "1_590468_2500_1935942574_67145_3_162055179_95777912_640153992",
            "ratePlanName": "漫趣主题房",
            "paymentType": 0,
            "averagePrice": 177.00,
            "pricePerDay": "125.0|229.0",
            "stockPerDay": "99|99",
            "confirmType": 1,
            "breakfast": "不含早餐",
            "cancelRule": {
              "name": "限时取消",
              "type": 2,
              "desc": "2020-07-27 16:00:00前可免费取消修改，我们不会收取房费。如未入住或取消修改及提前离店，我们将收取您全额房费（含税费）。" ,
              "freeCancelLatestTime": "2020-07-27 16:00:00"
            }
          }
        ]
      },
      {
        "roomId": 2049770381,
        "roomName": "榻榻米大床房",
        "useableArea": "18㎡",
        "capacity": "2",
        "floor": "4层",
        "internetWay": null,
        "bedType": "榻榻米",
        "pictures": [
          {
            "path": "http://m.tuniucdn.com/fb3/s1/2n9c/3ZMMMBYxmBoeuCzVLrij8zJMZPVT.jpg",
            "name": "榻榻米大床房"
          }
        ],
        "facilities": [
          {
            "name": "空调",
            "status": "1"
          },
          {
            "name": "衣柜/衣橱",
            "status": "1"
          },
          {
            "name": "220V电压插座",
            "status": "1"
          },
          {
            "name": "遮光窗帘",
            "status": "1"
          },
          {
            "name": "手动窗帘",
            "status": "1"
          },
          {
            "name": "床具:鸭绒被",
            "status": "1"
          },
          {
            "name": "电子秤",
            "status": "1"
          },
          {
            "name": "房间内高速上网",
            "status": "1"
          },
          {
            "name": "书桌",
            "status": "1"
          },
          {
            "name": "多种规格电源插座",
            "status": "1"
          },
          {
            "name": "有线频道",
            "status": "1"
          },
          {
            "name": "液晶电视机",
            "status": "1"
          },
          {
            "name": "电话",
            "status": "1"
          },
          {
            "name": "电热水壶",
            "status": "1"
          },
          {
            "name": "迷你吧",
            "status": "1"
          },
          {
            "name": "小冰箱",
            "status": "1"
          },
          {
            "name": "拖鞋",
            "status": "1"
          },
          {
            "name": "浴室化妆放大镜",
            "status": "1"
          },
          {
            "name": "24小时热水",
            "status": "1"
          },
          {
            "name": "浴衣",
            "status": "1"
          },
          {
            "name": "独立淋浴间",
            "status": "1"
          },
          {
            "name": "吹风机",
            "status": "1"
          }
        ],
        "ratePlans": [
          {
            "ratePlanId": "1_590468_2500_2049770381_67145_3_162055179_161610327_645866458",
            "ratePlanName": "榻榻米大床房",
            "paymentType": 0,
            "averagePrice": 214.00,
            "pricePerDay": "214.0|214.0",
            "stockPerDay": "99|99",
            "confirmType": 1,
            "breakfast": "不含早餐",
            "cancelRule": {
              "name": "不可退订",
              "type": 1,
              "desc": "不可退订",
              "freeCancelLatestTime": null
            }
          }
        ]
      },
      {
        "roomId": 1983648145,
        "roomName": "漫趣童趣亲子房",
        "useableArea": "18㎡",
        "capacity": "2",
        "floor": "4-5层",
        "internetWay": null,
        "bedType": "多床",
        "pictures": [
          {
            "path": "http://m.tuniucdn.com/fb2/t1/G6/M00/68/19/Cii-U13iooGIHvf5AAKNrfeELR0AAHr_gHTbFkAAo3F931.jpg",
            "name": "漫趣童趣亲子房"
          }
        ],
        "facilities": [
          {
            "name": "多种规格电源插座",
            "status": "1"
          },
          {
            "name": "220V电压插座",
            "status": "1"
          },
          {
            "name": "遮光窗帘",
            "status": "1"
          },
          {
            "name": "手动窗帘",
            "status": "1"
          },
          {
            "name": "书桌",
            "status": "1"
          },
          {
            "name": "床具:鸭绒被",
            "status": "1"
          },
          {
            "name": "电子秤",
            "status": "1"
          },
          {
            "name": "衣柜/衣橱",
            "status": "1"
          },
          {
            "name": "房间内高速上网",
            "status": "1"
          },
          {
            "name": "空调",
            "status": "1"
          },
          {
            "name": "电话",
            "status": "1"
          },
          {
            "name": "有线频道",
            "status": "1"
          },
          {
            "name": "液晶电视机",
            "status": "1"
          },
          {
            "name": "电热水壶",
            "status": "1"
          },
          {
            "name": "迷你吧",
            "status": "1"
          },
          {
            "name": "小冰箱",
            "status": "1"
          },
          {
            "name": "24小时热水",
            "status": "1"
          },
          {
            "name": "独立淋浴间",
            "status": "1"
          },
          {
            "name": "吹风机",
            "status": "1"
          },
          {
            "name": "拖鞋",
            "status": "1"
          },
          {
            "name": "浴衣",
            "status": "1"
          },
          {
            "name": "浴室化妆放大镜",
            "status": "1"
          }
        ],
        "ratePlans": [
          {
            "ratePlanId": "1_590468_2500_1983648145_67145_3_162055179_98117562_640154031",
            "ratePlanName": "漫趣童趣亲子房",
            "paymentType": 0,
            "averagePrice": 241.00,
            "pricePerDay": "187.0|295.0",
            "stockPerDay": "99|99",
            "confirmType": 1,
            "breakfast": "不含早餐",
            "cancelRule": {
              "name": "不可退订",
              "type": 1,
              "desc": "不可退订",
              "freeCancelLatestTime": null
            }
          }
        ]
      },
      {
        "roomId": 0,
        "roomName": "游游海洋主题房",
        "useableArea": "不确定",
        "capacity": "2",
        "floor": "不确定",
        "internetWay": null,
        "bedType": "不确定",
        "pictures": [],
        "facilities": [],
        "ratePlans": [
          {
            "ratePlanId": "1_590468_2500_0_67145_3_162055179_111209425_640243225",
            "ratePlanName": "游游海洋主题房",
            "paymentType": 0,
            "averagePrice": 476.00,
            "pricePerDay": "476.0|476.0",
            "stockPerDay": "99|99",
            "confirmType": 1,
            "breakfast": "不含早餐",
            "cancelRule": {
              "name": "不可退订",
              "type": 1,
              "desc": "不可退订",
              "freeCancelLatestTime": null
            }
          }
        ]
      },
      {
        "roomId": 1983648144,
        "roomName": "好玩CLUB亲子房",
        "useableArea": "25㎡",
        "capacity": "2",
        "floor": "4-6层",
        "internetWay": null,
        "bedType": "多床",
        "pictures": [
          {
            "path": "http://m.tuniucdn.com/fb2/t1/G6/M00/68/19/Cii-U13ion-IU96VAAHLGgFTXKMAAHr_gDdW2kAAcsy436.jpg",
            "name": "好玩CLUB亲子房"
          }
        ],
        "facilities": [
          {
            "name": "多种规格电源插座",
            "status": "1"
          },
          {
            "name": "220V电压插座",
            "status": "1"
          },
          {
            "name": "遮光窗帘",
            "status": "1"
          },
          {
            "name": "手动窗帘",
            "status": "1"
          },
          {
            "name": "书桌",
            "status": "1"
          },
          {
            "name": "床具:鸭绒被",
            "status": "1"
          },
          {
            "name": "电子秤",
            "status": "1"
          },
          {
            "name": "衣柜/衣橱",
            "status": "1"
          },
          {
            "name": "房间内高速上网",
            "status": "1"
          },
          {
            "name": "空调",
            "status": "1"
          },
          {
            "name": "电话",
            "status": "1"
          },
          {
            "name": "有线频道",
            "status": "1"
          },
          {
            "name": "液晶电视机",
            "status": "1"
          },
          {
            "name": "电热水壶",
            "status": "1"
          },
          {
            "name": "迷你吧",
            "status": "1"
          },
          {
            "name": "小冰箱",
            "status": "1"
          },
          {
            "name": "24小时热水",
            "status": "1"
          },
          {
            "name": "独立淋浴间",
            "status": "1"
          },
          {
            "name": "吹风机",
            "status": "1"
          },
          {
            "name": "拖鞋",
            "status": "1"
          },
          {
            "name": "浴衣",
            "status": "1"
          },
          {
            "name": "浴室化妆放大镜",
            "status": "1"
          }
        ],
        "ratePlans": [
          {
            "ratePlanId": "1_590468_2500_1983648144_67145_3_162055179_98117737_640153993",
            "ratePlanName": "好玩club亲子房",
            "paymentType": 0,
            "averagePrice": 627.50,
            "pricePerDay": "612.0|643.0",
            "stockPerDay": "99|99",
            "confirmType": 1,
            "breakfast": "不含早餐",
            "cancelRule": {
              "name": "不可退订",
              "type": 1,
              "desc": "不可退订",
              "freeCancelLatestTime": null
            }
          }
        ]
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/hotel/createOrder

返回格式： json

请求方法： post

接口说明：

下单流程图.png

请商户严格按照该预订流程对接，不然会存在：无效订单占比过高(即：只下单不支付的单子)，接口账户被系统自动封禁的风险。

终端用户尚未支付的商户本地酒店订单，没必要提前推送给磐河（终端用户支付后需采购时才推送过来即可），严禁高频率恶意下单不支付行为(会触发系统自动封禁账号的)，下单成功请及时支付,新订单30分钟未支付订单将自动取消。

请求参数：

参数名称	类型	必填	说明
customerOrderNo	string	是	商户订单号（即你们自己平台的本地订单号，用于双方订单关联映射。单号值必须唯一，否则会被系统判定为重复下单进行拦截）
hotelID	int	是	酒店ID
ratePlanID	string	是	产品（价格计划）ID
roomNum	int	是	房间数量
checkInDate	string	是	入住日期（格式：yyyy-MM-dd）
checkOutDate	string	是	离店日期（格式：yyyy-MM-dd）
guestNames	string[]	是	房客姓名，每个房间预留一个房客姓名。长度需和房间数量保持一致。
arriveTime	datetime	否	最晚到店时间，如：2020-07-27 16:00
orderAmount	float	是	订单总金额
contactName	string	是	订单联系人姓名
contactMobile	string	是	订单联系人手机号
contactEmail	string	否	订单联系人邮箱
callBackUrl	string	否	订单状态变更异步回调地址，回调详见:订单状态推送通知说明(不传就没有回调了)

返回参数：

参数名称	类型	说明
orderNo	string	酒店订单号

JSON请求示例 :

{
  "appKey": "您申请的APPKEY",
  "customerOrderNo": "123456",
  "hotelID": 590468,
  "ratePlanID": "1_590468_2500_1935942574_67145_3_162055179_95777912_640153992",
  "roomNum": 1,
  "checkInDate": "2020-07-27",
  "checkOutDate": "2020-07-29",
  "guestNames": [
    "张三丰"
  ],
  "arriveTime": "2020-07-27 16:00",
  "orderAmount": 254,
  "contactName": "张三",
  "contactMobile": "13752374523",
  "contactEmail": "123@qq.com",
  "orderRemark": "用户备注信息",
  "callBackUrl": "http://hotelNotify.abc.com/test/Notify"
}

JSON返回示例 :

{
  "data": {
    "orderNo": "2020072717350884167439"
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/hotel/getOrderDetail

返回格式： json

请求方法： get/post

请求示例： http://接口域名/hotel/getOrderDetail?appKey=您申请的APPKEY&orderNo=2020072713232677046416

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	酒店订单号

返回参数：

参数名称	类型	说明
orderNo	string	酒店订单号
customerOrderNo	string	商户订单号
numberOfRooms	int	预订房间数量
numberOfNights	int	间夜数量
arriveTime	datetime	最晚到底时间
checkInDate	string	入住日期
checkOutDate	string	离店日期
guestNames	string	入住人姓名，多个入住人姓名之间用‘\|’分割
remark	string	订单用户备注
orderAmount	float	订单总金额
orderStatus	int	订单状态（1=待付款，2=待确认，3=已确认，4=确认失败，5=已完成，6=取消中，7=取消失败，8=已取消）
payStatus	int	支付状态（0=待支付，1=已支付）
payTime	datetime	支付时间(支付成功才有值，格式：yyyy-MM-dd HH:mm:ss)
paymentType	int	支付方式(0未支付 1虚拟钱包支付 2支付宝 3微信暂时只支持虚拟钱包支付)
transactionNo	string	交易单号
refundAmount	float	订房失败或取消成功，退款金额
refundSuccessTime	datetime	订房失败或取消成功需退款，退款成功时间
refundTransactionNo	string	退款交易单号
refundTransactionMethods	string	退款交易方式 (对应枚举TransactionMethods值:0未支付 1钱包支付 2支付宝 3微信)
hotelId	int	酒店ID
hotelName	string	酒店名称
hotelAddress	string	酒店地址
roomTypeName	string	房型名称
bedTypeName	string	床型
ratePlanId	string	产品(价格计划)ID
pricePerDay	string	每日价格，以“\|”分隔，数量需与入住/离店时间对应，如2019-05-20入住，2019-05-22离店，300\|200指第1天300元，第2天200元
breakfastDesc	string	早餐规则描述
cancelPolicyType	int	取消政策类型(1不可取销,2限时取消,3收费取消)
cancelDesc	string	取消政策描述
freeCancelLatestTime	datetime	可以免费取消的最晚时间(当取消政策类型为：限时取消，才有值)
confirmationNumber	string	酒店确认号(可能为空，因为有的酒店不需要确认号)
contactName	string	联系人姓名
contactMobile	string	联系人手机号
contactEmail	string	联系人邮箱
payLimitTime	datetime	支付时限参考时间
unFinishedReason	string	订单预订失败或退订失败原因（比如超时未支付自动取消，酒店满房等。通过此字段可以得到预订失败原因）
createTime	datetime	下单时间

JSON返回示例 :

{
  "data": {
    "orderNo": "2020072713232677046416",
    "numberOfRooms": 1,
    "numberOfNights": 2,
    "arriveTime": "2020-07-27 16:00:00",
    "checkInDate": "2020-07-27 00:00:00",
    "checkOutDate": "2020-07-29 00:00:00",
    "guestNames": "张三丰",
    "remark": "用户备注信息",
    "orderAmount": 252.00,
    "orderStatus": 8,
    "payStatus": 0,
    "payTime": null,
    "paymentType": 0,
    "transactionNo": null,
    "refundAmount": null,
    "refundSuccessTime": null,
    "refundTransactionNo": null,
    "refundTransactionMethods": 0,
    "hotelId": 590468,
    "hotelName": "漫趣乐园酒店(上海国际旅游度假区乐园店)",
    "hotelAddress": "川沙路4518号",
    "roomTypeName": "漫趣主题房",
    "bedTypeName": "漫趣主题房",
    "ratePlanId": "1_590468_2500_1935942574_67145_3_162055179_95777912_640153992",
    "pricePerDay": "145.0|107.0",
    "breakfastCountPerDay": null,
    "breakfastDesc": "不含早餐",
    "cancelPolicyType": 2,
    "cancelDesc": "2020-07-27 16:00:00前可免费取消修改，我们不会收取房费。如未入住或取消修改及提前离店，我们将收取您全额房费（含税费）。",
    "freeCancelLatestTime": "2020-07-27 16:00:00",
    "confirmationNumber": null,
    "contactName": "张三",
    "contactMobile": "13752374523",
    "contactEmail": "123@qq.com",
    "payLimitTime": "2020-07-27 13:53:27",
    "unFinishedReason":"",
    "createTime": "2020-07-27 13:23:26"
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/hotel/autoPay

返回格式： json

请求方法： post

接口说明：

此接口方法同步返回支付结果，success=true即表示支付成功。支付成功不等于预订成功，具体预订结果会异步回调通知，以订单状态为准。

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	酒店订单号
payAmount	float	否	订单支付金额（可为null ,传值时将和订单金额进行比对；传值时就参与签名，为null时不参与签名）
sign	string	是	签名校验值，md5(secretKey+orderNo+payAmount+secretKey)，secretKey为请求密钥，开通账户时即可获得，加密结果转为32位小写。【注意：加密前的拼接原串不包含'+'】

返回参数：

参数名称	类型	说明
success	bool	true表示代扣支付成功；false表示代扣失败,msg为失败原因。

JSON请求示例 :

{
  "appKey": "您申请的APPKEY",
  "orderNo": "1804257654",
  "payAmount": 300,
  "sign":"17fb3f159a93cf6a5d0275565d1a0954"
}

JSON返回示例 :

{
    "data": true,
    "success": true,
    "msg": "请求成功"
}

接口地址： http://接口域名/hotel/cancelOrder

返回格式： json

请求方法： get/post

请求示例： http://接口域名/hotel/cancelOrder?appKey=您申请的APPKEY&orderNo=2020072713232677046416

接口说明：

只有‘待付款’和‘已确认’状态下的订单才允许取消操作

1.如果订单未付款即订单状态为‘待付款’时，可调用该接口直接取消成功，接口会同步返回取消结果的（不再异步通知）；

2.如果订单预订成功后即订单状态为‘已确认’时需要退订，务必根据取消政策核损。可调用【订单详情接口】获取取消政策；此时接口返回成功，只表示申请成功（申请成功后订单状态为‘取消中’）。只有当订单状态变为”已取消“时，才是真正的取消成功（在‘取消中’状态下无论取消成功还是取消失败都会异步推送）；

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	酒店订单号

返回参数：

参数名称	类型	说明
success	bool	true表示取消成功；false表示取消失败,msg为取消失败原因

JSON返回示例 :

JSON返回示例 :	"//取消成功返回：
{
    ""data"": true,
    ""success"": true,
    ""msg"": ""请求成功""
}
 
//取消失败返回：
{
  ""data"": null,
  ""success"": false,
  ""msg"": ""只有‘待付款’状态下才允许取消,当前订单状态为‘酒店确认中’""
}"

	内容	详细
	售前咨询:	15021905015
	客服热线:	17306152795
	在线客服QQ:	1437759532
	测试工具:	推荐使用PostMan
	技术支持:	info@panhe.net

在线接口文档中心

酒店

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :