b450b512a2
- 添加 mipu-api 作为 git submodule (Claude Code Skill) - 迁移 API 文档源文件到 docs/ 目录统一维护 - 添加 Gitea Actions 工作流：tag推送自动打包docs并发布Release - Skill 运行时自动从 mipu-open Release 下载最新文档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
31 lines
3.0 KiB
Markdown
31 lines
3.0 KiB
Markdown
<!-- mipuyun-api-doc: segment-element -->
|
||
# 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的情况。
|
||
|