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>
1.7 KiB
1.7 KiB
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 日） |
备注
- 请求体内的旅行时间是departureDate，不同于响应体的departureTime：原因是航司会出现出发时间的调整，为了保障成功率，请求只需要告知日期即可。
- 本实体兼容FlightSegmentResponse, 你可以把shopping/search中获得实体直接引用。
- 如入参为departureTime，我们会抛弃时间，只采用日期。
- stopCities 为可选字段，仅在航班包含经停点时需要填写。格式为多个城市三字码用
/分隔，例如 "CDG/MAD" 表示经停巴黎和马德里。