行程查询及价格估算

  • 接口(建议后缀):/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 行政区划编码(仅国内城市有)

results matching ""

    No results matching ""