mipu-open/docs/08-03_segment-element.md

FlightSegmentResponse

FlightSegment 对象定义

Segment 对象用于描述单段航班的核心信息（如在搜索结果中的去程航段 outboundSegments、返程航段 inboundSegments），具体定义如下：

字段名	数据类型	示例值	说明
index	Integer	1 / 2	航段序号，按行程顺序递增（一般用于转机行程，第一段去程为 1，第二段去程为 2），非空且唯一
carrier	String	"VJ"	承运航司 IATA 二字码（如 VJ = 越南航空），与 flightNumber 前缀的航司码一致（示例中 flightNumber="VJ884"，carrier="VJ" 符合规则）
flightNumber	String	"VJ884"	航班号，格式为 “航司二字码 + 数字”：
operatingFlightnumber	String	""	实际承运航班号：- 代码共享航班时，填写实际承运航司的航班号- 非代码共享航班时，空字符串或与 flightNumber 一致（示例中为非代码共享，故为空）
operatingCarrier	String	""	实际承运航司 IATA 二字码：- 代码共享航班（codeShare=true）时，需填写实际承运航司（如 carrier="CA"，operatingCarrier="MU"）- 非代码共享航班（codeShare=false）时，空字符串或与 carrier 一致（示例中为非代码共享，故为空）
originAirport	String	"BOM" / "SGN"	出发机场 IATA 三字码（如 BOM = 孟买贾特拉帕蒂・希瓦吉国际机场，SGN = 胡志明市新山一国际机场）
departureTime	String	"202510270040"	起飞日期时间，固定格式 YYYYMMDDHHMM（202510270040 表示 2025 年 10 月 27 日 00:40）
destinationAirport	String	"SGN" / "SYD"	到达机场 IATA 三字码（如 SYD = 悉尼金斯福德・史密斯机场）
arrivalTime	String	"202510270705"	到达日期时间，格式同 depTime（202510280805 表示 2025 年 10 月 28 日 08:05）
stopCities	String	""	经停地，空字符串表示直飞
duration	int	295 / 515	飞行时长，单位为分钟（295 分钟 = 4 小时 55 分钟，515 分钟 = 8 小时 35 分钟）
codeShare	boolean	false	代码共享标识：- true = 代码共享航班（由其他航司实际承运）- false = 非代码共享航班（由 carrier 航司直接承运）
cabin	String	""	舱位等级代码（如 "Y"= 经济舱、"C"= 公务舱），空字符串表示未明确具体舱位代码
aircraftCode	String	"330"	机型编码（如 "330"= 空客 A330，"738"= 波音 737-800），用于标识执飞客机型号
departureTerminal	String	"T1"	起飞机场航站楼（如 "T2"=2 号航站楼），空字符串表示未明确航站楼信息（需以机场实时通知为准）
arrivalTerminal	String	"T1"	到达机场航站楼，规则同 departureTerminal

特殊业务规则备注

1. 航班号前 0 规则：响应体内的航班号会按照航司接口中获取数据原样返回，请注意处理是否带0的情况。