Verify

Verify
请求参数
object/routing Element
array/Segment Element
请求示例
返回参数
object/Routing Element
返回示例

用途：用于验证机票价格是否发生变化，保证预定环节的价格准确性
请求方式：POST
接口加密：否

请求参数

参数名称	类型	必填	说明
requestId	`string`	✅	请求ID，预订环节中的各个接口是唯一的，可通过本字段串连一个完整的预订流程，长度32位
tripType	`int`	✅	行程类型：1 单程、2 往返
adultNumber	`int`	✅	成人乘客的数量
childNumber	`int`	⬜	儿童乘客的数量
infantNumber	`int`	⬜	婴儿乘客的数量
routing	`object/routing Element`	✅	用于记录行程信息
isResidentDiscountEligible	`bool`	⬜	true代表订单使用岛民折扣价格，默认false
siteChannel	`int`	⬜	站点来源,每个站点的服务要求不同。如1：代表site1
customerPriceInfo	`string`	⬜	客户查询接口拿到的价格信息，json格式，示例：{“adt”: {“fare”: 23.45, “tax”: 5.86},”chd”: {“fare”: 23.45, “tax”: 5.86},”inf”: {“fare”: 23.45, “tax”: 5.86}}

object/routing Element

参数名称	类型	必填	说明
data	`string`	✅	search接口返回的data原文，用于供应商做内部业务串联
fromSegments	`array/Segment Element`	✅	去程的行程信息
retSegments	`array/Segment Element`	⬜	回程的行程信息
packageInfo	`object/packageInfo Element`	⬜	套餐信息，参考search接口的packageInfo Element
issuePolicyType	`string`	⬜	暂未启用，产品类型，不填写代表标准产品（退改规定以航空公司为准），目前AeroHub只有标准产品，R1代表标准产品-退改以航司为准，R2代表退改自定义产品，S1代表按照禁止拆分PNR出票，S2代表允许按往返行程拆分PNR出票，T1代表按照ServiceTag Element要求时间内出票，T2代表24小时内出票，T3代表72小时内或航变起飞48小时内出票（取先到时间），每次请求每个分类必须且有唯一值有返回，并且严格遵照R,S,T的顺序使用’,’分隔。如R1,S2,T1代表允许返回标准退改，允许拆分订单出票，出票时间符合站点要求的产品。注意：每个字母表示一个分类，其中R1只允许和T1进行组合，但是可以和S类型任意组合；R2可以和任意的T和S类型进行组合。

array/Segment Element

参数名称	类型	必填	说明
marketingCarrier	`string`	✅	航空公司代码，采用 IATA 二字代码做为标准，与flightNumber中的前两位对应
depAirport	`string`	✅	出发机场代码，采用 IATA 三字代码做为标准
depTime	`string`	✅	起飞日期和起飞时间（当地时间），格式：YYYYMMDDHHMM，例如202303100300 表示 2023年3月10日3时0分
arrAirport	`string`	✅	到达机场代码，采用 IATA 三字代码做为标准
arrTime	`string`	✅	到达日期和到达时间（当地时间），格式：YYYYMMDDHHMM，例如202303101305 表示 2023年3月10日13时5分
seatGrade	`string`	✅	舱等，F 头等舱、C 商务舱、S 超级经济舱、Y 经济舱
seatClass	`string`	✅	舱位
flightNumber	`string`	✅	航班号，如：CA123
codeShare	`bool`	✅	本航班是否是共享航班，true 是共享航班、false 不是共享航班，若返回true，则operatingCarrier和operatingFlightNo必须返回
aircraftCode	`string`	⬜️	机型，采用 IATA 三字代码做为标准
segmentNo	`int`	⬜️	航程顺序，1 去程，2 回程
operatingCarrier	`string`	⬜	实际承运的航空公司代码，采用 IATA 二字代码做为标准，与operatingFlightNo中的前两位对应
operatingFlightNo	`string`	⬜	实际承运的航班号
stopCities	`string`	⬜	经停城市，多个用/分开，采用 ISO 3166 三字代码做为标准
stopAirports	`string`	⬜	经停机场，多个用/分开，采用 ISO 3166 三字代码做为标准

请求示例

{
    "requestId": "74e155e75f9d4a33",
    "tripType": 2,
    "adultNumber": 1,
    "childNumber": 0,
    "infantNumber": 0,
    "routing": {
        "data": "DST_djlfOUNCMkNCSl9QVkdoU2l0ZV9fX18w",
        "fromSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "PVG",
            "depTime": "202302100915",
            "arrAirport": "HKG",
            "arrTime": "202302101220",
            "seatGrade": "",
            "seatClass": "V",
            "flightNumber": "9C8921",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 1,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "retSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "HKG",
            "depTime": "202302151320",
            "arrAirport": "PVG",
            "arrTime": "202302151545",
            "seatClass": "V",
            "seatGrade": "",
            "flightNumber": "9C8922",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 2,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "packageInfo":null
    },
    "siteChannel": ""
}

返回参数

参数名称	类型	必填	说明
marketErrorCode	`int`	✅	供应商系统错误码，用于协助AeroHub与供应商排查问题，请如实返回真实错误
marketErrorMsg	`string`	✅	供应商系统错误描述，请如实返回真实错误原因，长度小于 300
sessionId	`string`	✅	会话标识，供应商在预定环节串联各个接口的唯一标识，由数字或字母组成，最大长度40字符
maxSeats	`int`	✅	可预订的最大座位数，最大为9，不可小于验价请求时的人数。
routing	`object/routing Element`	✅	验价返回行程信息

object/Routing Element

参数名称	类型	必填	说明
data	`string`	✅	供应商自用，可保存必要信息，Order时会将Verify时的原始数据放在请求报文中返传给供应商，长度不超过64位
fromSegments	`array/Segment Element`	✅	去程的行程信息，参考请求
retSegments	`array/Segment Element`	⬜️	回程的行程信息，参考请求
priceList	`array/priceList Element`	✅	不同乘客类型的机票价格，参考search接口
eligibility	`string`	⬜️	旅客身份三字码，NOR 普通成人、LAB 劳务人员、SEA 海员、SNR 老年人、STU 学生、YOU 青年
validatingCarrier	`string`	✅	实际出票的航空公司代码，采用 IATA 二字代码做为标准
issuePolicyType	`string`	⬜️	产品类型，不填写代表标准产品（退改规定以航空公司为准），目前AeroHub只有标准产品，R1代表标准产品-退改以航司为准，R2代表退改自定义产品，S1代表按照禁止拆分PNR出票，S2代表允许按往返行程拆分PNR出票，T1代表按照ServiceTag Element要求时间内出票，T2代表24小时内出票，T3代表72小时内或航变起飞48小时内出票（取先到时间），每次请求每个分类必须且有唯一值有返回，并且严格遵照R,S,T的顺序使用’,’分隔。如R1,S2,T1代表允许返回标准退改，允许拆分订单出票，出票时间符合站点要求的产品。注意：每个字母表示一个分类，其中R1只允许和T1进行组合，但是可以和S类型任意组合；R2可以和任意的T和S类型进行组合。
fareBasis	`string`	⬜️	与GDS中的票价等级相对应，每个航段一个，多个时用”;”隔开
bookingOfficeNo	`string`	⬜️	订位Office号，AeroHub预留字段，现阶段可传空
ticketingOfficeNo	`string`	⬜️	出票Office号，AeroHub预留字段，现阶段可传空
reservationType	`string`	⬜️	政策来源，AeroHub预留字段，现阶段可传空
posCode	`string`	⬜️	出票国家代码，采用 ISO 3166 二字码做为标准，多个出票地用 “\|” 隔开
complexTerm	`int`	⬜️	特殊产品预留字段，AeroHub目前没有特殊产品，本字段可传0
minAge	`int`	⬜️	本次航班对乘客的最小年龄限制，0代表无限制
maxAge	`int`	⬜️	本次航班对乘客的最大年龄限制，0代表无限制
planCategory	`int`	⬜️	AeroHub预留字段
invoiceType	`string`	✅	供应商可提供的凭证类型，T 行程单、F 发票、E 电子发票
minPassengerCount	`int`	⬜️	本次航班的最小可售卖人数，从1开始
maxPassengerCount	`int`	⬜️	本次航班的最大可售卖人数
note	`string`	⬜️	备注信息，最大 300 个字符
airlineAncillaries	`object/airlineAncillaries Element`	⬜️	行李信息，用于反映是否可售卖行李和是否有免费行李，参考search接口
formatBaggageDetailList	`array/formatBaggageDetailList Element`	⬜️	套餐中的行李信息，参考search接口
refundInfoList	`array/refundInfoList Element`	⬜️	退票规则，参考search接口
changesInfoList	`array/changesInfoList Element`	⬜️	改签规则，参考search接口
packageInfo	`object/packageInfo Element`	⬜️	套餐信息，参考search接口
currency	`string`	✅	报价币种，一般和供应商约定的结算币种一致
ticketTimeUnit	`int`	⬜️	出票时长，以秒做为计量单位，用于匹配AeroHub对不同产品的出票要求，返回值会优先匹配，优先比价
combineIndexs	`array`	⬜️	拼接报价拼接点，AeroHub预留字段，当前没有，可传空
endorsement	`int`	⬜️	是否支持签转，0 不支持、1 支持

返回示例

Success-Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful",
    "sessionId": "aNBOGd3p7Kf72ALZOQY",
    "maxSeats": 9,
    "routing": {
        "data": "DST_djlfOUNCMkNCSl9QVkdfSEtHXzIwMj",
        "fromSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "PVG",
            "depTime": "202302100915",
            "arrAirport": "HKG",
            "arrTime": "202302101220",
            "seatGrade": "",
            "seatClass": "V",
            "flightNumber": "9C8921",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 1,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "retSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "HKG",
            "depTime": "202302151320",
            "arrAirport": "PVG",
            "arrTime": "202302151545",
            "seatClass": "V",
            "seatGrade": "",
            "flightNumber": "9C8922",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 2,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "priceList": [{
            "passengerType": 0,
            "publishPrice": 0,
            "price": 608,
            "taxFeeAmount": 369,
            "taxFeeDisclosureList": []
        },
        "eligibility": "NOR",
        {
            "passengerType": 1,
            "publishPrice": 0,
            "price": 608,
            "taxFeeAmount": 369,
            "taxFeeDisclosureList": []
        }],
        "validatingCarrier": "9C",
        "productType": "",
        "fareBasis": "",
        "bookingOfficeNo": "",
        "ticketingOfficeNo": "",
        "reservationType": "",
        "posCode": "",
        "complexTerm": 0,
        "minAge": 0,
        "maxAge": 0,
        "planCategory": 0,
        "invoiceType": "E",
        "minPassengerCount": 1,
        "maxPassengerCount": 9,
        "note": "xxx",
        "airlineAncillaries": {
            "baggageService": true,
            "unFreeBaggage": true
        },
        "formatBaggageDetailList": [],
        "refundInfoList": [{
            "passengerType": 0,
            "refundType": 0,
            "refundStatus": "T",
            "refundFee": 0,
            "refNoshow": "T",
            "refNoShowCondition": 0,
            "refNoshowFee": 0,
            "conditionList": []
        },
        {
            "passengerType": 1,
            "refundType": 0,
            "refundStatus": "T",
            "refundFee": 0,
            "refNoshow": "T",
            "refNoShowCondition": 0,
            "refNoshowFee": 0,
            "conditionList": []
        }],
        "changesInfoList": [{
            "passengerType": 0,
            "changesType": 0,
            "changesStatus": "T",
            "changesFee": 0,
            "revNoshow": "T",
            "revNoShowCondition": 0,
            "revNoshowFee": 0,
            "conditionList": ""
        },
        {
            "passengerType": 1,
            "changesType": 0,
            "changesStatus": "T",
            "changesFee": 0,
            "revNoshow": "T",
            "revNoShowCondition": 0,
            "revNoshowFee": 0,
            "conditionList": ""
        }],
        "packageInfo": null,
        "currency": "USD",
        "ticketTimeUnit": 1000,
        "combineIndexs": [],
        "endorsement": 0
    }
}

Error-Response

{
    "marketErrorCode": 5118,
    "marketErrorMsg": "System error"
}

Author：AeroHub Create time：2023-07-10 16:10
Last editor：AeroHub Update time：2025-10-28 15:50