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>
24 lines
1.7 KiB
Markdown
24 lines
1.7 KiB
Markdown
<!-- mipuyun-api-doc: flight-segment-request -->
|
||
# 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" 表示经停巴黎和马德里。
|
||
|