行程查询及价格估算
- 接口(建议后缀):/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 | 行政区划编码(仅国内城市有) |