国际机票大卖家API
接口说明
- 选择搜索接口，点击确定渠道和接口类型，系统会给出搜索必要条件的输入框，其中cid是卖家提供的，每个卖家有自己的cid，其他输入相应的参数（如果是往返需录入回调日期retDate）；
- 点击“生成请求Json”，可得到标准结构的请求json；
注意：平台只支持单程往返两种航程，因此fromCity/ toCity只能输入一个城市三字码；
- 点击接口测试，可以得到结果分析、接口返回报文、JSON结构化报文展示；其中结果分析中给出了调用时长，和平台解析报文的报错信息。
结果分析
- 搜索结果正确，结果分析：此业务校验正常
- 搜索结果有问题被平台的规则过滤，结果分析会给出具体的错误原因。
下面列举了几种过滤规则，后续还将有增加。
| 过滤规则 | 结果分析说明 |
|---|---|
| 返回结果json格式错误 | JSON格式不正确， 原因：…… |
| 返回数据是否为空校验 | 搜索无结果 |
| 返回数据状态校验 | status is fail. 结果为不成功。 |
| 返程数据格式检验 | Pls use [] instead of null. 当返程为空请按照范例格式返回 “retSegments”:[] |
| Routings非空检验 | routings is null or empty. 搜索无结果。 |
| applyType=1 | ApplyType should be 0. 包含申请价被过滤。 |
| adultTaxType=1 | AdultTaxType should be 0. 成人税费类型为1被过滤。 |
| AdultTax | AdultTax should be greater than 0. 成人税费应大于0。 |
| AdultPrice | AdultPrice should be greater than 0. 成人票面应大于0。 |
| 去程航程信息为空 | FromSegments is null or empty. 去程航段为空被过滤 |
| 去程航段数大于2 | FromSegments.size should be less than 3. 去程航段大于2程被过滤。 |
| 回程航段数大于2 | RetSegments size should be less than 3. 回程航段大于2程被过滤。 |
| 空铁联运过滤规则 | AircraftCode [TRN] is invalid. 系统不支持此机型被过滤。不支持巴士和火车航段。 |
| 去程航司IATA二字码检验 | FromSegments error: carrier length should be 2. Your flightNumber is XXXXXX and carrier is X. 去程carrier格式错误，应为航司IATA二字码。 |
| 去程出发机场码校验 | FromSegments error: depAirport Code Error! Your depAirport is XXX. Bus or train is not allowed. 去程出发机场码不支持被过滤。不支持巴士和火车航段。 |
| 去程到达机场码校验 | FromSegments error: arrAirport Code Error! Your arrAirport is XXX. Bus or train is not allowed.去程到达机场码不支持被过滤。不支持巴士和火车航段。 |
| 回程航司IATA二字码检验 | RetSegments error: carrier length should be 2. The flightNumber is XXXXXX and carrier is X. 回程carrier格式错误，应为航司IATA二字码。 |
| 去程出发机场码校验 | RetSegments error: depAirport Code Error! Your depAirport is XXX. Bus or train is not allowed. 回程出发机场码不支持被过滤。不支持巴士和火车航段。 |
| 回程到达机场码校验 | RetSegments error: arrAirport Code Error! Your arrAirport is XXX. Bus or train is not allowed. 回程到达机场码不支持被过滤。不支持巴士和火车航段。 |
| 去程机型码校验 | FromSegments error: aircraftCode Error! The aircraftCode is XXX. 去程机型码错误。 |
| 去程航班号校验 | FromSegments error: flightNumber Error! The fightNumber is XXXXX. 去程航班号错误。 |
| 去程仓位校验 | FromSegments error: cabin Error! The cabin is XX. 去程舱位错误。 |
| 回程机型码校验 | RetSegments error: aircraftCode Error! The aircraftCode is XXX. 回程机型码错误。 |
| 回程航班号校验 | RetSegments error: flightNumber Error! The fightNumber is XXXXX. 回程航班号错误。 |
| 回程仓位校验 | RetSegments error: cabin Error! The cabin is XX. 回程舱位错误。 |
| 行程出发到达信息与搜索一致性检验 | Routing airports-time is not match search cities-date.当前行程出发-到达机场与搜索行程出发-到达城市不一致被过滤。请检查机场码是否正确、原始日期格式是否符合YYYYMMDDHHMM。Search cities and date:XXXYYYYMMDDXXX. Routing cities and date:XXXYYYYMMDDXXX. The routing is XXXXXXXXXXX |
不展示排查
搜索结果JSON结构化展示内容，点击“线上不展示检测”，可以查看该航班是否在搜索list页展示，以及不展示的原因。