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>
43 lines
2.2 KiB
Markdown
43 lines
2.2 KiB
Markdown
<!-- mipuyun-api-doc: flight-policy -->
|
||
# FlightPolicy
|
||
|
||
# FlightPolicy 实体定义（基于实际响应）
|
||
|
||
该实体用于描述航班的附加产品信息（如免费行李额、退改规则等），字段与最新响应数据完全对齐。
|
||
|
||
> **注意**：去程和回程的免费行李额分别存储在 `FlightFare.flightPolicy` 和 `FlightFare.rtnFlightPolicy` 中，因此 `freeBaggageList` 不再包含 `journeyDirection` 字段来区分方向。
|
||
|
||
| **字段名** | **数据类型** | **示例值** | **说明** |
|
||
| --- | --- | --- | --- |
|
||
| airlineCode | String | "SL" | 航司代码 |
|
||
| fareFamilyType | String | "Lion Economy" | 舱位/子舱位类型名称 |
|
||
| description | String | | 政策描述 |
|
||
| freeAncillaryList | List\<FreeAncillary\> | | 免费行李额列表（详见下方说明） |
|
||
| refundRules | List\<RefundRule\> | | 退票规则列表（预留字段，暂未提供） |
|
||
| changeRules | List\<ChangeRule\> | | 改签规则列表（预留字段，暂未提供） |
|
||
|
||
## freeAncillaryList（FreeAncillary）
|
||
|
||
免费行李额元素，描述每个航段、每种乘客类型的免费行李配额。
|
||
|
||
| **字段名** | **数据类型** | **示例值** | **说明** |
|
||
| --- | --- | --- | --- |
|
||
| categoryCode | String | "StandardCheckedBaggage" | 辅营类型代码：`StandardCheckedBaggage` = 托运行李，`CabinBaggageUnderSeat` = 客舱行李（座椅下），`CabinBaggageOverheadLocker` = 客舱行李（行李架） |
|
||
| segmentIndex | Integer | 1 | 航段序号，从 1 开始 |
|
||
| paxType | String | "ADT" | 乘客类型：`ADT` = 成人，`CHD` = 儿童，`INF` = 婴儿 |
|
||
| piece | Integer | 1 | 行李件数（PC） |
|
||
| weight | Integer | 20 | 行李重量（KG） |
|
||
| size | String | | 行李尺寸 |
|
||
|
||
**示例：**
|
||
|
||
```json
|
||
{
|
||
"freeAncillaryList": [
|
||
{ "categoryCode": "CabinBaggageOverheadLocker", "segmentIndex": 1, "paxType": "ADT", "piece": 1, "weight": 7 },
|
||
{ "categoryCode": "StandardCheckedBaggage", "segmentIndex": 1, "paxType": "ADT", "piece": 1, "weight": 20 },
|
||
{ "categoryCode": "CabinBaggageOverheadLocker", "segmentIndex": 2, "paxType": "ADT", "piece": 1, "weight": 7 },
|
||
{ "categoryCode": "StandardCheckedBaggage", "segmentIndex": 2, "paxType": "ADT", "piece": 1, "weight": 20 }
|
||
]
|
||
}
|
||
``` |