行程查询及价格估算
- 接口(建议后缀):/trip/inquire
- Method:POST
- 数据格式:Json
- 调用方:每刻
- 接口说明:每刻将通过该接口根据出发城市/目的城市和舱位/坐席到差旅平台查询行程可选方案
请求参数
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
externalCorpCode | String | Y | 企业在第三方的唯一标识 |
externalEmployeeCode | String | Y | 查询人在第三方的唯一编码 |
inquireType | int | Y | 指定查询机票、酒店和火车的预估价(1机票,2酒店,4火车),允许同时查询,例如传 1 是只查机票,3 查询机票和酒店,7 是查询机票、酒店和火车[1] |
departureCity | City | Y | 出发城市 |
arrivalCity | City | Y | 到达城市 |
departureDate | String | Y | 出发日期(yyyy-MM-dd) |
returnDate | String | N | 返程日期(yyyy-MM-dd),仅tripType=R有效 |
cabin | String | N | 参考机票舱位等级:如:Y\C\F |
seat | String | N | 参考火车订单接口的坐席类别,如:FIRST_CLASS, SECOND_CLASS |
tripType | String | N | 行程类型, 单程S,往返R (计算往返的最高价之和) 默认S |
[info] 说明:
[1] 对应的二进制 bit,由低到高,第0位:机票, 第1位:酒店,第2位:火车票。允许同时查,如 5(101),表示同时查机票和火车票的预估价,7(111),表示同时查机票、酒店和火车票的预估价
响应结构
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
success | bool | Y | 请求是否成功 |
errorMessage | String | N | 失败信息(当 success 为 false 时,失败信息为必填) |
data | TripDetail | Y | 行程详情 |
TripDetail 行程详情
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
flightList | List<Flight> | N | 满足条件的航班信息列表 |
trainList | List<Train> | N | 满足条件的火车信息列表 |
hotelList | List<Hotel> | N | 满足条件的酒店信息列表(待完善) |
Flight 航班信息
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
returnTrip | bool | Y | 是否返程,默认false,表示去程 |
flightNo | String | N | 航班号 |
airlineName | String | N | 航空公司名称 |
airlineCode | String | N | 航空公司编码 |
departureAt | String | Y | 出发时间(yyyy-MM-dd HH:mm:ss) |
departureCity | City | Y | 出发城市 |
departurePortCode | String | N | 出发机场三字码 |
departurePortName | String | N | 出发机场名称 |
arrivalAt | String | Y | 降落时间(yyyy-MM-dd HH:mm:ss) |
arrivalCity | City | Y | 降落城市 |
arrivalPortCode | String | N | 降落机场三字码 |
arrivalPortName | String | N | 降落机场名称 |
cabin | String | N | 参考机票舱位等级:如:Y\C\F |
ticketPrice | BigDecimal | Y | 折后票价 |
standardTicketPrice | BigDecimal | Y | 票本价 |
discount | int | Y | 百分比折扣(范围0-100的整数,比如75%,此字段值为75) |
oilFee | BigDecimal | Y | 燃油附加费 |
taxFee | BigDecimal | Y | 机建费 |
Train 火车信息
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
returnTrip | bool | Y | 是否返程,默认false,表示去程 |
trainNo | String | N | 车次号 |
departureAt | String | Y | 出发时间(yyyy-MM-dd HH:mm:ss) |
departureCity | City | Y | 出发城市 |
departureStation | String | N | 出发车站名称 |
arrivalAt | String | Y | 到达时间(yyyy-MM-dd HH:mm:ss) |
arrivalCity | City | Y | 到达城市 |
arrivalStation | String | N | 到达车站名称 |
seat | String | N | 参考火车订单接口的坐席类别,如:FIRST_CLASS, SECOND_CLASS |
ticketPrice | BigDecimal | Y | 票价 |
City 城市
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
code | String | Y | 每刻城市编码 |
name | String | Y | 每刻城市名称 |
heirCode | String | N | 每刻城市继承链编码 |
heirName | String | N | 每刻城市继承链名称 |
adminDivCode | String | N | 行政区划编码(仅国内城市有) |