version:1.0.0
非JSON格式传递的参数,请使用form-data的方式传值
默认所有接口请求头部(header)中加入如下参数
timestamp: 请求的当前时间戳,秒
sign: sign=Md5("app"你提供给调用者的应用编号"secret"你提供给调用者的应用秘钥"timestamp"+秒级时间戳)
app: 调用者的应用编号
1. ChannelPlatformRest
1.1. 根据国家获取酒店列表(无报价信息)
请求
GET /api/channel/supp/getHotelList?countryCode=&language=en-US&pageIndex=0&pageSize=0 HTTP/1.1
名称 | 类型 | 校验 | 默认 | 描述 |
---|---|---|---|---|
countryCode |
String |
国家编码 CN US |
||
language |
String |
en-US |
语言 |
|
pageIndex |
int |
0 |
页码 - 从 1 开始 |
|
pageSize |
int |
0 |
每页大小 - 最大200 |
响应
HTTP/1.1 200 OK
{
"code" : 0,
"bizCode" : 0,
"message" : "",
"costTime" : "",
"data" : [ {
"id" : "",
"name" : "",
"address" : "",
"countryCode" : "",
"countryName" : "",
"cityName" : "",
"latitude" : 0,
"longitude" : 0,
"roomList" : [ {
"code" : "",
"roomName" : "",
"roomNameEn" : "",
"description" : "",
"maxOccupancy" : 0,
"bedTypeDesc" : "",
"bedRoomList" : [ {
"beds" : [ [ {
"bedType" : "",
"bedSize" : "",
"count" : 0
} ] ]
} ]
} ]
} ]
}
名称 | 类型 | 校验 | 默认 | 描述 |
---|---|---|---|---|
code |
int |
0 |
系统代码 |
|
bizCode |
int |
0 |
发生业务错误时对应的代码 |
|
message |
String |
消息 |
||
costTime |
String |
系统代码 |
||
data |
List |
数据 |
||
data.[].id |
String |
酒店id |
||
data.[].name |
String |
酒店名字 |
||
data.[].address |
String |
地址 |
||
data.[].countryCode |
String |
国家id |
||
data.[].countryName |
String |
国家 |
||
data.[].cityName |
String |
城市 |
||
data.[].latitude |
Double |
0 |
纬度 |
|
data.[].longitude |
Double |
0 |
经度 |
|
data.[].roomList |
List |
房间列表 |
||
data.[].roomList.[].code |
String |
房间编码 |
||
data.[].roomList.[].roomName |
String |
房间名字 |
||
data.[].roomList.[].roomNameEn |
String |
房型名称(英文) |
||
data.[].roomList.[].description |
String |
描述 |
||
data.[].roomList.[].maxOccupancy |
Integer |
0 |
最大入住人数 |
|
data.[].roomList.[].bedTypeDesc |
String |
床型描述 |
||
data.[].roomList.[].bedRoomList |
List |
床型列表 |
||
data.[].roomList.[].bedRoomList.[].beds |
List |
床型,二维,外层是“或”关系 |
||
data.[].roomList.[].bedRoomList.[].beds.[].[].bedType |
String |
床型 |
||
data.[].roomList.[].bedRoomList.[].beds.[].[].bedSize |
String |
床尺寸 |
||
data.[].roomList.[].bedRoomList.[].beds.[].[].count |
Integer |
0 |
床数量 |
|
data.[].roomList.[].bedRoomList.[].hasBathroom |
Boolean |
是否有卫生间 |
1.2. 获取报价(多酒店)
请求
GET /api/channel/supp/getPrices?hotelIds=&checkInDate=&checkOutDate=&occupancy=&language=en-US&roomNum=0¤cy=USD HTTP/1.1
名称 | 类型 | 校验 | 默认 | 描述 |
---|---|---|---|---|
hotelIds |
String |
酒店编号集合,用,分隔,最多20家 |
||
checkInDate |
String |
入住日期 |
||
checkOutDate |
String |
离店日期 |
||
occupancy |
String |
国际产品专属:入住人信息 2-5-3代表2成人2个儿童(1个5岁,1个3岁) 多间房下滑线_分割 |
||
language |
String |
en-US |
语言 连字符BCP47格式 zh-CN en-US |
|
roomNum |
Integer |
0 |
房间数量 |
|
currency |
String |
USD |
币种 |
响应
HTTP/1.1 200 OK
{
"code" : 0,
"bizCode" : 0,
"message" : "",
"costTime" : "",
"data" : [ {
"id" : "",
"name" : "",
"address" : "",
"countryCode" : "",
"countryName" : "",
"cityName" : "",
"minPrice" : 0,
"roomList" : [ {
"roomId" : "",
"roomName" : "",
"description" : "",
"minBasePrice" : 0,
"ratePlans" : [ {
"ratePlanId" : "",
"ratePlanName" : "",
"description" : "",
"breakfast" : 0,
"lunch" : 0,
"dinner" : 0,
"mealType" : 0,
"cancelRules" : [ {
"desc" : "",
"descOrig" : "",
"deductType" : 0,
"startTime" : "",
"endTime" : "",
"startTimeOrig" : "",
"endTimeOrig" : ""
} ],
"cancelable" : 0,
"currency" : "",
"offlineFee" : 0,
"offlineFeeCurrency" : "",
"basePrice" : 0,
"deepLink" : "",
"tax" : 0
} ]
} ],
"latitude" : 0,
"longitude" : 0
} ]
}
名称 | 类型 | 校验 | 默认 | 描述 |
---|---|---|---|---|
code |
int |
0 |
系统代码 |
|
bizCode |
int |
0 |
发生业务错误时对应的代码 |
|
message |
String |
消息 |
||
costTime |
String |
系统代码 |
||
data |
List |
数据 |
||
data.[].id |
String |
酒店id |
||
data.[].name |
String |
酒店名字 |
||
data.[].address |
String |
地址 |
||
data.[].countryCode |
String |
国家id |
||
data.[].countryName |
String |
国家 |
||
data.[].cityName |
String |
城市 |
||
data.[].minPrice |
BigDecimal |
0 |
最低价格 |
|
data.[].roomList |
List |
房间列表(包含报价信息) |
||
data.[].roomList.[].roomId |
String |
物理房型ID |
||
data.[].roomList.[].roomName |
String |
物理房型名称 |
||
data.[].roomList.[].description |
String |
描述 |
||
data.[].roomList.[].minBasePrice |
BigDecimal |
0 |
最低价格 |
|
data.[].roomList.[].ratePlans |
List |
价格计划信息 |
||
data.[].roomList.[].ratePlans.[].ratePlanId |
String |
价格计划编号 |
||
data.[].roomList.[].ratePlans.[].ratePlanName |
String |
价格计划名称 |
||
data.[].roomList.[].ratePlans.[].description |
String |
描述 |
||
data.[].roomList.[].ratePlans.[].breakfast |
Integer |
0 |
早餐 |
|
data.[].roomList.[].ratePlans.[].lunch |
Integer |
0 |
午餐 -国际 |
|
data.[].roomList.[].ratePlans.[].dinner |
Integer |
0 |
晚餐 -国际 |
|
data.[].roomList.[].ratePlans.[].mealType |
Integer |
0 |
餐食类型 - Unknown(0), 明确数量,具体看字段breakfast,lunch,dinner(1),半包(2),全包(3),午晚二选一(4),早午早晚二选一(5) |
|
data.[].roomList.[].ratePlans.[].cancelRules |
List |
取消规则 |
||
data.[].roomList.[].ratePlans.[].cancelRules.[].desc |
String |
描述 |
||
data.[].roomList.[].ratePlans.[].cancelRules.[].descOrig |
String |
当地时间规则描述 |
||
data.[].roomList.[].ratePlans.[].cancelRules.[].deductType |
Integer |
0 |
取消手续费类型: Unknown(0) - 未知, FirstDay(1) - 扣首日, Full(2) - 扣全额, Percent(3) - 按价格多少百分比扣, Free(4) - 免费取消, ManyDay(5) - 扣几晚, Money(6) - 扣多少钱, LimitedFree(7) - 有条件免费取消 |
|
data.[].roomList.[].ratePlans.[].cancelRules.[].startTime |
String |
取消规则的生效日期和时间 本地时间 |
||
data.[].roomList.[].ratePlans.[].cancelRules.[].endTime |
String |
取消规则的结束日期和时间 本地时间 |
||
data.[].roomList.[].ratePlans.[].cancelRules.[].startTimeOrig |
String |
取消规则的生效日期和时间 当地时间 |
||
data.[].roomList.[].ratePlans.[].cancelRules.[].endTimeOrig |
String |
取消规则的结束日期和时间 当地时间 |
||
data.[].roomList.[].ratePlans.[].cancelable |
boolean |
0 |
是否可取消,可取消看取消规则 |
|
data.[].roomList.[].ratePlans.[].currency |
String |
货币 |
||
data.[].roomList.[].ratePlans.[].offlineFee |
BigDecimal |
0 |
到店付费用(到店支付城市税) |
|
data.[].roomList.[].ratePlans.[].offlineFeeCurrency |
String |
到店付币种 |
||
data.[].roomList.[].ratePlans.[].basePrice |
BigDecimal |
0 |
价格(总,多日单间价格) |
|
data.[].roomList.[].ratePlans.[].deepLink |
String |
deepLink |
||
data.[].roomList.[].ratePlans.[].tax |
BigDecimal |
0 |
税费 |
|
data.[].latitude |
Double |
0 |
纬度 |
|
data.[].longitude |
Double |
0 |
经度 |