改期-航班搜索报价

  • 用途：改期搜索报价模式
    供应侧提供接口
  • 请求方式：POST
  • 接口加密：否

请求参数

参数名称 类型 必填 说明
requestId string ✅ 请求ID；每次调用是唯一的，长度32位
purchaseOrderNo string ✅ AeroHub的订单号
changeType string ✅ 改期类型；VOLUNTARY:自愿改期
INVOLUNTARY: 非自愿改期
changeReason string ⬜ 非自愿改期原因；changeType=INVOLUNTARY时有值
FLIGHT_CHANGE:航班变更
FLIGHT_CANCEL:航班取消
passengers array/passengers Element ✅ 需要变更的乘客
fromSegments array/fromSegments Element ✅ 需要改期的原单回程航段信息
retSegments array/retSegments Element ⬜ 需要改期的原单去程航段信息

array/passengers Element

参数名称 类型 必填 说明
lastName string ✅ 乘客last name；大写
firstName string ✅ 乘客first name；大写
birthday string ✅ 生日；格式：xxxx-xx-xx
cardNo string ⬜ 证件号
ageType int ✅ 乘客类型；0:成人
1:儿童
2:婴儿
gender string ✅ 乘客性别；F:男, M:女
nationality string ⬜ 国籍二字码；ISO国家二字码
expired string ⬜ 证件过期时间；格式：xxxx-xx-xx

array/fromSegments Element

参数名称 类型 必填 说明
segmentNumber int ✅ 行程序号；1开始
depAirport string ✅ 到达机场；机场三字码
arrAirport string ✅ 到达机场；机场三字码
flightNumber string ✅ 航班号
depTime string ✅ 出发时间；格式：YYYY-MM-DD HH:MM
arrTime string ✅ 到达时间；格式：YYYY-MM-DD HH:MM
newDepDate string ✅ 新出发日期；格式：YYYY-MM-DD

array/retSegments Element

参数名称 类型 必填 说明
segmentNumber int ✅ 行程序号；1开始
depAirport string ✅ 到达机场；机场三字码
arrAirport string ✅ 到达机场；机场三字码
flightNumber string ✅ 航班号
depTime string ✅ 出发时间；格式：YYYY-MM-DD HH:MM
arrTime string ✅ 到达时间；格式：YYYY-MM-DD HH:MM
newDepDate string ✅ 新出发日期；格式：YYYY-MM-DD

请求示例

{
    "requestId": "string",
    "purchaseOrderNo": "string",
    "changeType": "string",
    "changeReason": "string",
    "passengers": [
        {
            "ageType": 0,
            "gender": "string",
            "lastName": "string",
            "firstName": "string",
            "birthday": "string",
            "nationality": "string",
            "cardNo": "string",
            "expired": "string"
        }
    ],
    "fromSegments": [
        {
            "segmentNumber": 0,
            "flightNumber": "string",
            "depAirport": "string",
            "arrAirport": "string",
            "depTime": "string",
            "arrTime": "string",
            "newDepDate": "string"
        }
    ],
    "retSegments": [
        {
            "segmentNumber": 0,
            "flightNumber": "string",
            "depAirport": "string",
            "arrAirport": "string",
            "depTime": "string",
            "arrTime": "string",
            "newDepDate": "string"
        }
    ]
}

返回参数

参数名称 类型 必填 说明
code int ✅ code码；200表示成功，其它均表示失败
特殊返回值：
201: 订单无法改期
202: 订单不支持自动报价，需人工报价
msg string ✅ 消息；一般用户错误提示，code不等于200时必传
flightList array/flightList Element ✅ 航班列表；可改期的航班列表

array/flightList Element

参数名称 类型 必填 说明
amount int ✅ 改期总额
currency string ✅ 币种
changeFee float ✅ 变更费
fareDifference float ✅ 票面仓差
taxDifference float ⬜ 税仓差
costDetails array/costDetails Element ✅ 价格明细
fromSegments array/fromSegments Element ⬜ 去程航段信息；必须根据请求参数里面的fromSegments返回数据
retSegments array/retSegments Element ⬜ 回程航段信息；参考去程航段信息
如请求参数包含回程信息，该字段必须返回
必须根据请求参数里面的retSegments返回数据
rules object/rules Element ⬜ 客规信息
routingKey string ✅ routingKey
array/costDetails Element
参数名称 类型 必填 说明
changeFee int ✅ 变更费
passengerType int ✅ 乘客类型；0成人 1儿童 2 婴儿
fareDifference int ✅ 票面价仓差
taxDifference int ✅ 税仓差
array/fromSegments Element
参数名称 类型 必填 说明
segmentNumber string ✅ 航段序号；航段顺序1开始
carrier string ✅ 航司二字码
flightNumber string ✅ 航班号
codeShare bool ✅ 是否共享航班
operatingFlightNumber string ⬜ 承运航班号；codeShare=true 时必传
operatingCarrier string ⬜ 承运航司；codeShare=true 时必传
depAirport string ✅ 出发机场
depTerminal string ✅ 出发航站楼
arrAirport string ✅ 到达机场
arrTerminal string ✅ 到达航站楼
depTime string ✅ 出发时间；格式：YYYY-MM-DD HH:MM
arrTime string ✅ 到达时间；格式：YYYY-MM-DD HH:MM
duration int ✅ 飞行时长；单位分钟
aircraftCode string ✅ 机型
stopAirports array/stopAirports Element ⬜ 经停信息
priceList array/priceList Element ✅ 票价明细
cabinClass string ✅ 舱等；舱等，F 头等舱、C 商务舱、S 超级经济舱、Y 经济舱
seatClass string ✅ 舱位
array/stopAirports Element
参数名称 类型 必填 说明
stopAirport string ✅ 经停机场；采用 IATA 三字代码
stopDuration int ✅ 经停时长；单位分钟
stopCity string ✅ 经停城市；采用 ISO 3166 三字代码
stopoverArrivalTime string ✅ 经停地到达时间；格式：YYYY-MM-DD HH:MM
stopoverDepartureTime string ✅ 经停地起飞时间；格式：YYYY-MM-DD HH:MM
array/priceList Element
参数名称 类型 必填 说明
fareSequence int ✅ -
availableCount int ✅ -
fareKey string ✅ -
fareBasisCode string ✅ -
cabinClass string ✅ -
cabinName string ✅ -
productClass string ✅ -
issuePolicyType string ✅ -
fareTypeCode string ✅ -
fareTypeDesc string ✅ -
paxFare array/paxFare Element ✅ -
array/paxFare Element
参数名称 类型 必填 说明
passengerType int ✅ -
publishPrice float ✅ -
price float ✅ -
taxFeeAmount float ✅ -
taxFeeDisclosureList array/taxFeeDisclosureList Element ✅ -
object/rules Element
参数名称 类型 必填 说明
refundInfoList array/refundInfoList Element ✅ 退款客规；https://doc.faremarket.aerohubtech.com/docs/fareMarket/Search
changesInfoList array/changesInfoList Element ✅ 改期客规；https://doc.faremarket.aerohubtech.com/docs/fareMarket/Search
formatBaggageDetailList array/formatBaggageDetailList Element ✅ 免费行李；https://doc.faremarket.aerohubtech.com/docs/fareMarket/Search
array/refundInfoList Element
参数名称 类型 必填 说明
refundType int ✅ -
refundStatus string ✅ -
refundFee int ✅ -
refNoshowFee int ✅ -
refNoshow string ✅ -
refNoShowCondition int ✅ -
passengerType int ✅ -
conditionList array/conditionList Element ✅ -
array/conditionList Element
参数名称 类型 必填 说明
- - - 源文档未定义字段
array/changesInfoList Element
参数名称 类型 必填 说明
passengerType int ✅ -
changesType int ✅ -
changesStatus string ✅ -
changesFee int ✅ -
revNoshow string ✅ -
revNoShowCondition int ✅ -
revNoShowFee int ✅ -
conditionList array/conditionList Element ✅ -
array/conditionList Element
参数名称 类型 必填 说明
status string ✅ -
endMinute int ✅ -
amount float ✅ -
array/formatBaggageDetailList Element
参数名称 类型 必填 说明
baggagePiece int ✅ -
baggageWeight int ✅ -
flightSeq int ✅ -
passengerType int ✅ -
segmentNo int ✅ -

返回示例

Success-Response

{
    "code": 0,
    "msg": "string",
    "flightList": [
        {
            "routingKey": "string",
            "amount": 0,
            "changeFee": 0,
            "fareDifference": 0,
            "taxDifference": 0,
            "costDetails": [
                {
                    "passengerType": 0,
                    "changeFee": 0,
                    "fareDifference": 0,
                    "taxDifference": 0
                }
            ],
            "currency": "string",
            "fromSegments": [
                {
                    "segmentNumber": "string",
                    "carrier": "string",
                    "flightNumber": "string",
                    "codeShare": true,
                    "operatingFlightNumber": "string",
                    "operatingCarrier": "string",
                    "depAirport": "string",
                    "depTerminal": "string",
                    "arrAirport": "string",
                    "arrTerminal": "string",
                    "depTime": "string",
                    "arrTime": "string",
                    "duration": 0,
                    "aircraftCode": "string",
                    "cabinClass": "string",
                    "seatClass": "string",
                    "stopAirports": [
                        {
                            "stopAirport": "string",
                            "stopDuration": 0,
                            "stopCity": "string",
                            "stopoverArrivalTime": "string",
                            "stopoverDepartureTime": "string"
                        }
                    ],
                    "priceList": [
                        {
                            "fareSequence": 0,
                            "availableCount": 0,
                            "fareKey": "string",
                            "fareBasisCode": "string",
                            "cabinClass": "string",
                            "cabinName": "string",
                            "productClass": "string",
                            "issuePolicyType": "string",
                            "fareTypeCode": "string",
                            "fareTypeDesc": "string",
                            "bundleId": 0,
                            "ruleId": "string",
                            "paxFare": [
                                {
                                    "passengerType": 0,
                                    "publishPrice": 0,
                                    "price": 0,
                                    "taxFeeAmount": 0,
                                    "taxFeeDisclosureList": [
                                        "string"
                                    ]
                                }
                            ]
                        }
                    ]
                }
            ],
            "retSegments": [
                {}
            ],
            "rules": {
                "refundInfoList": [
                    {
                        "refundType": 0,
                        "refundStatus": "string",
                        "refundFee": 0,
                        "refNoshowFee": 0,
                        "refNoshow": "string",
                        "refNoShowCondition": 0,
                        "passengerType": 0,
                        "conditionList": [
                            "string"
                        ]
                    }
                ],
                "changesInfoList": [
                    {
                        "passengerType": 0,
                        "changesType": 0,
                        "changesStatus": "string",
                        "changesFee": 0,
                        "revNoshow": "string",
                        "revNoShowCondition": 0,
                        "revNoShowFee": 0,
                        "conditionList": [
                            {
                                "status": "string",
                                "endMinute": 0,
                                "amount": 0
                            }
                        ]
                    }
                ],
                "formatBaggageDetailList": [
                    {
                        "baggagePiece": 0,
                        "baggageWeight": 0,
                        "flightSeq": 0,
                        "passengerType": 0,
                        "segmentNo": 0
                    }
                ]
            }
        }
    ]
}
Author：AeroHub  Create time：2026-08-14 15:46
Last editor：AeroHub  Update time：2026-10-20 11:34