检索符合条件酒店列表
说明：请求方法: POST
请求数据类型: JSON
响应类型: JSON
请求头："Accept":"application/json",
"Content-Type":"application/json"
使用此接口可检索酒店的相关信息，查询结果可以使用分页的方式返回
请求方式：POST（HTTPS）
请求地址：https://btbapi.sctt.net/h1/SearchHotelList
请求包体：
{
"merchant_id":287729,
"request_time":"2023-02-11 11:48:00",
"sign":"D19A61DBE64BA6CFB547855F216E0201",
"indexId":0,
"countPerPage":200,
"data":{
"arrival":"2023-03-05",
"departure":"2023-03-07",
"cityCode":"SYD",
"passengerCountryOfResidence":"CN",
"nationality":"CN",
"maxPrice":1000
}
}
参数说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| merchant_id | 是 | bigint | 商户编号 |
| request_time | 是 | string | 请求时间,格式：“yyyy-MM-dd HH:mm:ss” |
| sign | 是 | string | 签名 |
| indexId | 是 | number | 分页的起始位置 |
| countPerPage | 是 | number | 每页的行数 |
| data | 是 | object | 酒店信息请求参数 |
| - nationality | 是 | string | 入住人员的国籍 (ISO二 位国家代码 如：CN， AU，NZ) |
| - passengerCountryOfResidence | 是 | string | 入住人员的居住国 (ISO 二位国家代码 如： CN，AU，NZ) |
| - preferredHotels | 否 | array[string] | 酒店 uuid 列表 |
| - roomGuests | 否 | array[object] | 入住客人信息实体 |
| - - adults | 否 | number | 如果填写了入住客 人实 体，此字段为 必填，其值 要大于 0，小于9 |
| - - children | 否 | number | 如果填写了入住客 人实 体，此字段为 必填，其值 要大于 等于0，小于7 |
| - - childrenAges | 否 | string | 儿童年龄列表，如 果 “children”字 段设置了大于 0的 值，此字段需要以 逗 号分隔的形式给 出儿童年 龄的列表。比如随行两名 儿 童，此字段需要写 入 “3,5”。年龄 的范围为：0- 16岁 |
| - - minStar | 否 | number | 最小1，最大5 |
| - - maxStar | 否 | number | 最小1，最大5 |
| - arrival | 是 | string | 入住时间，日期格式：yyyy- mmdd。预订晚 数没有限定， 但晚 数过多就没有查询 结 果。如果拿到了 查询结 果，那就说 明是可以预定 的 |
| - departure | 是 | string | 退房时间，日期格式：yyyy- mm-dd |
| - cityCode | 是 | string | 城市编码 |
| - currency | 否 | string | 目前统一用AUD |
| - rooms | 否 | number | 预订房间数量。一 般情况 下，房间数 量不能大于10 间 |
| - locale | 否 | string | 信息描述语言，备 选数 值："zh_CN"中 文,"en_AU"英文 |
| - maxPrice | 是 | number | 0-1000 |
| - minPrice | 否 | number | 0-1000 |
| - onRequest | 否 | boolean | 是否返回预订时需 要人工 确认（不能 通过API直接预 订）的酒店数据 |
| - sortType | 否 | string | 查询结果的排序方 式，可 使用的值包 括： PRICE（按价 格从低到 高），HOTEL_STAR（按 星级从低到高）， RANKING（按 推荐指数从 高到底） |
返回结果：
{
"code": 0,
"msg": "ok",
"data": {
"status": 0,
"payload": {
"totalCount": 7,
"firstRow": 0,
"countPerPage": 200,
"resultSize": 7,
"results": [
{
"hotelUuid": "1b5c6b2c-efc6-45ba-a699-9a5488f773ad",
"price": 892.5,
"currency": "AUD",
"secondaryPrice": 892.5,
"secondaryCurrency": "AUD",
"freeCancellation": true,
"hotelName": "悉尼洲际酒店",
"originalName": "InterContinental Sydney ",
"rank": 1266,
"rating": 5,
"mapDetails": {
"latitude": -33.86335109,
"longitude": 151.21189892
},
"thumbNailUrls": [
"http://images-hz.ptctravel.net.cn/b2b/hotels/AU/SYD/IS1MSS-704794-1642038307162.png"
],
"amenities": [
{
"id": 0,
"name": " Non-smoking rooms Fitness centre Room service Restaurant WiFi available in all areas Private parking Tea/coffee maker in all rooms Bar Very good breakfast",
"imageUrl": null,
"groupName": null
}
],
"hotelRating": {
"type": "star",
"starRating": 5
},
"adults": 0,
"children": 0,
"onRequest": false,
"mealsPlan": {
"breakfast": false,
"description": null
},
"favorite": false,
"recommendReason": [],
"distanceToCbd": 1.1378,
"distanceToAirport": 9.2441,
"distanceToTarget": -1
},
{
"hotelUuid": "c98e3eb5-8346-4465-977d-6e6654431647",
"price": 378,
"currency": "AUD",
"secondaryPrice": 378,
"secondaryCurrency": "AUD",
"freeCancellation": true,
"hotelName": "悉尼中央新城马洛酒店",
"originalName": "Metro Hotel Marlow Sydney Central",
"rank": 336,
"rating": 4,
"mapDetails": {
"latitude": -33.879379,
"longitude": 151.207074
},
"thumbNailUrls": [
"http://images-hz.ptctravel.net.cn/b2b/hotels/AU/SYD/MHMSC4-8098-1576088924510.jpg"
],
"amenities": [
{
"id": 0,
"name": " Non-smoking rooms Airport shuttle Family rooms Room service Restaurant Free WiFi Tea/coffee maker in all rooms Bar",
"imageUrl": null,
"groupName": null
}
],
"hotelRating": {
"type": "star",
"starRating": 4
},
"adults": 0,
"children": 0,
"onRequest": false,
"mealsPlan": {
"breakfast": false,
"description": null
},
"favorite": false,
"recommendReason": [],
"distanceToCbd": 0.8204,
"distanceToAirport": 7.3707,
"distanceToTarget": -1
},
{
"hotelUuid": "53786474-1eba-4a7e-980c-3ee697972973",
"price": 300.3,
"currency": "AUD",
"secondaryPrice": 300.3,
"secondaryCurrency": "AUD",
"freeCancellation": true,
"hotelName": "帕拉马塔内苏托公寓酒店",
"originalName": "Nesuto Parramatta",
"rank": 102,
"rating": 4,
"mapDetails": {
"latitude": -33.82419311,
"longitude": 151.0207352
},
"thumbNailUrls": [
"http://images-hz.ptctravel.net.cn/b2b/hotels/AU/SYD/NPSAH1-704981-1643328964561.png"
],
"amenities": [
{
"id": 0,
"name": "1 swimming pool Non-smoking rooms Restaurant WiFi available in all areas Private parking Parking Free WiFi",
"imageUrl": null,
"groupName": null
}
],
"hotelRating": {
"type": "star",
"starRating": 4
},
"adults": 0,
"children": 0,
"onRequest": false,
"mealsPlan": {
"breakfast": false,
"description": null
},
"favorite": false,
"recommendReason": [],
"distanceToCbd": 17.962,
"distanceToAirport": 19.2046,
"distanceToTarget": -1
},
{
"hotelUuid": "50498b64-ac1e-4d70-ac88-9b71e4e2facb",
"price": 483,
"currency": "AUD",
"secondaryPrice": 483,
"secondaryCurrency": "AUD",
"freeCancellation": true,
"hotelName": "Nesuto Woolloomooloo",
"originalName": "Nesuto Woolloomooloo",
"rank": 93,
"rating": 3,
"mapDetails": {
"latitude": -33.87026634,
"longitude": 151.22153074
},
"thumbNailUrls": [
"http://images-hz.ptctravel.net.cn/b2b/hotels/AU/SYD/NWSA8D-705014-1643340146949.png"
],
"amenities": [
{
"id": 0,
"name": "Non-smoking rooms Free WiFi Parking Family rooms Lift",
"imageUrl": null,
"groupName": null
}
],
"hotelRating": {
"type": "star",
"starRating": 3
},
"adults": 0,
"children": 0,
"onRequest": false,
"mealsPlan": {
"breakfast": false,
"description": null
},
"favorite": false,
"recommendReason": [],
"distanceToCbd": 1.3757,
"distanceToAirport": 8.8159,
"distanceToTarget": -1
},
{
"hotelUuid": "ba91dc54-016f-42a1-84cc-3fb7673b124d",
"price": 472.5,
"currency": "AUD",
"secondaryPrice": 472.5,
"secondaryCurrency": "AUD",
"freeCancellation": true,
"hotelName": "悉尼机场斯坦福广场酒店和会议中心",
"originalName": "Stamford Plaza Sydney Airport ",
"rank": 77,
"rating": 5,
"mapDetails": {
"latitude": -33.93107,
"longitude": 151.18567
},
"thumbNailUrls": [
"http://images-hz.ptctravel.net.cn/b2b/hotels/AU/SYD/SPSACR-705846-1664432198532.png"
],
"hotelRating": {
"type": "star",
"starRating": 5
},
"adults": 0,
"children": 0,
"onRequest": false,
"mealsPlan": {
"breakfast": false,
"description": null
},
"favorite": false,
"recommendReason": [],
"distanceToCbd": 6.8271,
"distanceToAirport": 1.448,
"distanceToTarget": -1
},
{
"hotelUuid": "56405f24-1b8c-4e78-a294-4a9547e6cec3",
"price": 472.5,
"currency": "AUD",
"secondaryPrice": 472.5,
"secondaryCurrency": "AUD",
"freeCancellation": true,
"hotelName": "悉尼美居酒店",
"originalName": "Mercure Sydney",
"rank": 357,
"rating": 4,
"mapDetails": {
"latitude": -33.88428,
"longitude": 151.20293
},
"thumbNailUrls": [
"http://images-hz.ptctravel.net.cn/b2b/hotels/AU/SYD/MS8GSS-706040-1669877826297.png"
],
"amenities": [
{
"id": 0,
"name": "卫生纸",
"imageUrl": null,
"groupName": null
},
{
"id": 1,
"name": "毛巾",
"imageUrl": null,
"groupName": null
},
{
"id": 2,
"name": "浴缸或淋浴",
"imageUrl": null,
"groupName": null
},
{
"id": 3,
"name": "私人浴室",
"imageUrl": null,
"groupName": null
},
{
"id": 4,
"name": "卫生间",
"imageUrl": null,
"groupName": null
},
{
"id": 5,
"name": "免费洗浴用品",
"imageUrl": null,
"groupName": null
},
{
"id": 6,
"name": "吹风机",
"imageUrl": null,
"groupName": null
},
{
"id": 7,
"name": "淋浴",
"imageUrl": null,
"groupName": null
},
{
"id": 8,
"name": "床单",
"imageUrl": null,
"groupName": null
},
{
"id": 9,
"name": "衣柜/衣橱",
"imageUrl": null,
"groupName": null
},
{
"id": 10,
"name": "闹钟",
"imageUrl": null,
"groupName": null
},
{
"id": 11,
"name": "阳光露台",
"imageUrl": null,
"groupName": null
},
{
"id": 12,
"name": "露台",
"imageUrl": null,
"groupName": null
},
{
"id": 13,
"name": "电烧水壶",
"imageUrl": null,
"groupName": null
},
{
"id": 14,
"name": "冰箱",
"imageUrl": null,
"groupName": null
},
{
"id": 15,
"name": "床头插座",
"imageUrl": null,
"groupName": null
},
{
"id": 16,
"name": "晾衣架",
"imageUrl": null,
"groupName": null
},
{
"id": 17,
"name": "衣架",
"imageUrl": null,
"groupName": null
},
{
"id": 18,
"name": "欢乐时光 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 19,
"name": "高尔夫球场（3公里内） 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 20,
"name": "客厅角",
"imageUrl": null,
"groupName": null
},
{
"id": 21,
"name": "书桌",
"imageUrl": null,
"groupName": null
},
{
"id": 22,
"name": "平板电视",
"imageUrl": null,
"groupName": null
},
{
"id": 23,
"name": "有线频道",
"imageUrl": null,
"groupName": null
},
{
"id": 24,
"name": "卫星频道",
"imageUrl": null,
"groupName": null
},
{
"id": 25,
"name": "收音机",
"imageUrl": null,
"groupName": null
},
{
"id": 26,
"name": "电话",
"imageUrl": null,
"groupName": null
},
{
"id": 27,
"name": "电视",
"imageUrl": null,
"groupName": null
},
{
"id": 28,
"name": "住宿内咖啡店",
"imageUrl": null,
"groupName": null
},
{
"id": 29,
"name": "水果 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 30,
"name": "红酒/香槟 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 31,
"name": "特别节食菜单（应要求提供）",
"imageUrl": null,
"groupName": null
},
{
"id": 32,
"name": "小吃吧",
"imageUrl": null,
"groupName": null
},
{
"id": 33,
"name": "在客房内享用早餐",
"imageUrl": null,
"groupName": null
},
{
"id": 34,
"name": "酒吧",
"imageUrl": null,
"groupName": null
},
{
"id": 35,
"name": "迷你吧",
"imageUrl": null,
"groupName": null
},
{
"id": 36,
"name": "餐厅",
"imageUrl": null,
"groupName": null
},
{
"id": 37,
"name": "沏茶/咖啡设备",
"imageUrl": null,
"groupName": null
},
{
"id": 38,
"name": "停车库",
"imageUrl": null,
"groupName": null
},
{
"id": 39,
"name": "电动车充电站",
"imageUrl": null,
"groupName": null
},
{
"id": 40,
"name": "无障碍停车场",
"imageUrl": null,
"groupName": null
},
{
"id": 41,
"name": "提供发票",
"imageUrl": null,
"groupName": null
},
{
"id": 42,
"name": "礼宾服务",
"imageUrl": null,
"groupName": null
},
{
"id": 43,
"name": "自动提款机（酒店内部）",
"imageUrl": null,
"groupName": null
},
{
"id": 44,
"name": "行李寄存",
"imageUrl": null,
"groupName": null
},
{
"id": 45,
"name": "旅游咨询台",
"imageUrl": null,
"groupName": null
},
{
"id": 46,
"name": "外币兑换",
"imageUrl": null,
"groupName": null
},
{
"id": 47,
"name": "快速办理入住/退房手续",
"imageUrl": null,
"groupName": null
},
{
"id": 48,
"name": "24小时前台",
"imageUrl": null,
"groupName": null
},
{
"id": 49,
"name": "每日客房打扫",
"imageUrl": null,
"groupName": null
},
{
"id": 50,
"name": "熨裤机 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 51,
"name": "熨衣服务 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 52,
"name": "干洗 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 53,
"name": "洗衣 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 54,
"name": "传真/复印 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 55,
"name": "商务中心",
"imageUrl": null,
"groupName": null
},
{
"id": 56,
"name": "会议/宴会设施 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 57,
"name": "灭火器",
"imageUrl": null,
"groupName": null
},
{
"id": 58,
"name": "住宿外部闭路电视监控系统",
"imageUrl": null,
"groupName": null
},
{
"id": 59,
"name": "公共区域闭路电视监控系统",
"imageUrl": null,
"groupName": null
},
{
"id": 60,
"name": "烟雾报警器",
"imageUrl": null,
"groupName": null
},
{
"id": 61,
"name": "安全报警器",
"imageUrl": null,
"groupName": null
},
{
"id": 62,
"name": "刷卡进门",
"imageUrl": null,
"groupName": null
},
{
"id": 63,
"name": "24小时安保",
"imageUrl": null,
"groupName": null
},
{
"id": 64,
"name": "保险箱",
"imageUrl": null,
"groupName": null
},
{
"id": 65,
"name": "班车服务 额外收费",
"imageUrl": null,
"groupName": null
},
{
"id": 66,
"name": "住宿内小超市",
"imageUrl": null,
"groupName": null
},
{
"id": 67,
"name": "吸烟区",
"imageUrl": null,
"groupName": null
},
{
"id": 68,
"name": "空调",
"imageUrl": null,
"groupName": null
},
{
"id": 69,
"name": "酒店各处禁烟",
"imageUrl": null,
"groupName": null
},
{
"id": 70,
"name": "唤醒服务",
"imageUrl": null,
"groupName": null
},
{
"id": 71,
"name": "暖气",
"imageUrl": null,
"groupName": null
},
{
"id": 72,
"name": "隔音",
"imageUrl": null,
"groupName": null
},
{
"id": 73,
"name": "铺设了地毯的地板",
"imageUrl": null,
"groupName": null
},
{
"id": 74,
"name": "隔音客房",
"imageUrl": null,
"groupName": null
},
{
"id": 75,
"name": "电梯",
"imageUrl": null,
"groupName": null
},
{
"id": 76,
"name": "电风扇",
"imageUrl": null,
"groupName": null
},
{
"id": 77,
"name": "家庭间",
"imageUrl": null,
"groupName": null
},
{
"id": 78,
"name": "熨衣设备",
"imageUrl": null,
"groupName": null
},
{
"id": 79,
"name": "无障碍设施",
"imageUrl": null,
"groupName": null
},
{
"id": 80,
"name": "禁烟客房",
"imageUrl": null,
"groupName": null
},
{
"id": 81,
"name": "熨斗",
"imageUrl": null,
"groupName": null
},
{
"id": 82,
"name": "唤醒服务/闹钟",
"imageUrl": null,
"groupName": null
},
{
"id": 83,
"name": "客房服务",
"imageUrl": null,
"groupName": null
},
{
"id": 84,
"name": "高层由电梯直达",
"imageUrl": null,
"groupName": null
},
{
"id": 85,
"name": "全年开放",
"imageUrl": null,
"groupName": null
},
{
"id": 86,
"name": "不限年龄",
"imageUrl": null,
"groupName": null
},
{
"id": 87,
"name": "恒温泳池",
"imageUrl": null,
"groupName": null
},
{
"id": 88,
"name": "景观泳池",
"imageUrl": null,
"groupName": null
},
{
"id": 89,
"name": "屋顶泳池",
"imageUrl": null,
"groupName": null
},
{
"id": 90,
"name": "泳池/沙滩毛巾",
"imageUrl": null,
"groupName": null
},
{
"id": 91,
"name": "日光浴躺椅/沙滩椅",
"imageUrl": null,
"groupName": null
},
{
"id": 92,
"name": "健身房",
"imageUrl": null,
"groupName": null
},
{
"id": 93,
"name": "日光浴躺椅/沙滩椅",
"imageUrl": null,
"groupName": null
},
{
"id": 94,
"name": "健身中心",
"imageUrl": null,
"groupName": null
},
{
"id": 95,
"name": "德语",
"imageUrl": null,
"groupName": null
},
{
"id": 96,
"name": "英语",
"imageUrl": null,
"groupName": null
},
{
"id": 97,
"name": "法语",
"imageUrl": null,
"groupName": null
},
{
"id": 98,
"name": "印地语",
"imageUrl": null,
"groupName": null
},
{
"id": 99,
"name": "印尼语",
"imageUrl": null,
"groupName": null
},
{
"id": 100,
"name": "日语",
"imageUrl": null,
"groupName": null
},
{
"id": 101,
"name": "韩语",
"imageUrl": null,
"groupName": null
},
{
"id": 102,
"name": "马其顿语",
"imageUrl": null,
"groupName": null
},
{
"id": 103,
"name": "缅甸语",
"imageUrl": null,
"groupName": null
},
{
"id": 104,
"name": "俄语",
"imageUrl": null,
"groupName": null
},
{
"id": 105,
"name": "斯瓦西里语",
"imageUrl": null,
"groupName": null
},
{
"id": 106,
"name": "泰米尔语",
"imageUrl": null,
"groupName": null
},
{
"id": 107,
"name": "泰语",
"imageUrl": null,
"groupName": null
},
{
"id": 108,
"name": "菲律宾语",
"imageUrl": null,
"groupName": null
},
{
"id": 109,
"name": "乌尔都语",
"imageUrl": null,
"groupName": null
},
{
"id": 110,
"name": "越南语",
"imageUrl": null,
"groupName": null
},
{
"id": 111,
"name": "中文",
"imageUrl": null,
"groupName": null
}
],
"hotelRating": {
"type": "star",
"starRating": 4
},
"adults": 0,
"children": 0,
"onRequest": false,
"mealsPlan": {
"breakfast": false,
"description": null
},
"favorite": false,
"recommendReason": [],
"distanceToCbd": 1.4318,
"distanceToAirport": 6.701,
"distanceToTarget": -1
},
{
"hotelUuid": "0c5e0841-f01a-4e9d-b4f5-654320e729a5",
"price": 420,
"currency": "AUD",
"secondaryPrice": 420,
"secondaryCurrency": "AUD",
"freeCancellation": true,
"hotelName": "悉尼美罗阿斯皮尔酒店",
"originalName": "Metro Aspire Hotel Sydney",
"rank": 526,
"rating": 4,
"mapDetails": {
"latitude": -33.8803253,
"longitude": 151.19871318
},
"thumbNailUrls": [
"http://images-hz.ptctravel.net.cn/b2b/hotels/AU/SYD/MAHS3-704750-1641778711814.png"
],
"hotelRating": {
"type": "star",
"starRating": 4
},
"adults": 0,
"children": 0,
"onRequest": false,
"mealsPlan": {
"breakfast": false,
"description": null
},
"favorite": false,
"recommendReason": [],
"distanceToCbd": 1.2204,
"distanceToAirport": 6.9602,
"distanceToTarget": -1
}
]
}
}
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 接口返回信息 |
| data | object | 接口返回数据 |
| - status | int | 接口返回类型（0是成功,2是错误，会收 到 错误原因 |
| - payload | object | 酒店信息 |
| - - totalCount | number | 查询结果的总数 |
| - - firstRow | number | 分页的起始位置 |
| - - countPerPage | number | 每页的数量 |
| - - resultSize | number | 实际返回的酒店数量 |
| - - results | array[object] | 酒店详情 |
| - - - hotelUuid | string | 酒店的唯一编码 |
| - - - price | number | 酒店提供的原始价格，可忽 略 |
| - - - currency | string | 酒店提供的原始货币单 位， 可忽略 |
| - - - secondaryPrice | number | 酒店价格，货币单位与 请求 参数中的单位一致。默认 为：AUD |
| - - - secondaryCurrency | string | 默认为：AUD |
| - - - freeCancellation | boolean | 此参数表示此价格是否 可以 免费取消 |
| - - - hotelName | string | 酒店中文名字 |
| - - - originalName | string | 酒店英文名字 |
| - - - rank | number | 内部推荐指数 |
| - - - mapDetails | object | 酒店地理坐标 |
| - - - - latitude | number | 纬度 |
| - - - - longitude | number | 经度 |
| - - - thumbNailUrls | array[string] | 酒店图片，目前可返回 多张 酒店图片缩略图 |
| - - - hotelRating | object | 酒店星级实体 |
| - - - - type | string | 酒店星级的评定方式，目前 统一为：star |
| - - - - starRating | number | 星级：0-5,浮点数。 0：表 示无此酒店的星 级信息。 如果酒店是 3.5星，系统将 返回：3.5 |
| adults | number | 成人数量 |
| children | number | 儿童数量 |
| - - - onRequest | boolean | 如果是true,说明不能在 网上 直接预定，需要联 系SCTT 工作人员 |
| mealsPlan | object | 早餐计划 |
| breakfast | boolean | 是否包含早餐，如果包 含早 餐，则总价里已经 包含所有 入住人的早餐 费用 |
| description | string | 如果包含早餐，此字段 将描 述早餐的类型，目 前包括： 全早餐，欧式 早餐。如果没 有指定早 餐类型，则返回 空 |
| distanceToCbd | number | 酒店与CBD的距离 |
| distanceToAirport | number | 酒店与机场的距离 |
状态码说明：
| 状态码 | 说明 |
|---|---|
| 0 | 获取成功 |
| 4001 | 报文错误 |
| 4002 | 签名错误 |
| 4003 | 账号停用（商户账号，商户主账号 |