# FlightSegmentRequest # FlightSegmentRequest对象定义 Segment 对象用于描述单段航班的核心信息(告知我们定位到具体的行程),定义如下: | **字段名** | **数据类型** | **示例值** | **说明** | | --- | --- | --- | --- | | carrier | String | "VJ" | 承运航司 IATA 二字码(如 VJ = 越南航空),**与 flightNumber 前缀的航司码一致**(示例中 flightNumber="VJ884",carrier="VJ" 符合规则) | | flightNumber | String | "VJ884" | 航班号,格式为 "航司二字码 + 数字": | | originAirport | String | "BOM" / "SGN" | 出发机场 IATA 三字码(如 BOM = 孟买贾特拉帕蒂・希瓦吉国际机场,SGN = 胡志明市新山一国际机场) | | destinationAirport | String | "SGN" / "SYD" | 到达机场 IATA 三字码(如 SYD = 悉尼金斯福德・史密斯机场) | | stopCities | String | "CDG/MAD" | 经停地城市三字码,多个城市用 `/` 分隔(可选字段,用于支持包含经停点的航班查询) | | departureDate | String | "20251027" | 起飞日期日期,固定格式 `YYYYMMDD`(20251027表示 2025 年 10 月 27 日) | # 备注 1. **请求体内的旅行时间是departureDate,不同于响应体的departureTime**:原因是航司会出现出发时间的调整,为了保障成功率,请求只需要告知日期即可。 1. 本实体兼容FlightSegmentResponse, 你可以把shopping/search中获得实体直接引用。 1. 如入参为departureTime,我们会抛弃时间,只采用日期。 1. **stopCities 为可选字段**,仅在航班包含经停点时需要填写。格式为多个城市三字码用 `/` 分隔,例如 "CDG/MAD" 表示经停巴黎和马德里。