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>
2.6 KiB
2.6 KiB
FlightFare
FlightFare 实体用于描述不同乘客类型（成人 / 儿童 / 婴儿）的费用构成，拆分基础票价与税费等明细项，同时包含去程和返程的价格、政策信息，字段与实际响应完全对应。
说明：带
rtn前缀的字段为回程字段，仅往返程有值。
| 参数名称 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| fareBasis | String | 去 fareBasis 信息（如有） | |
| rtnFareBasis | String | 回程 fareBasis 信息（如有） | |
| fareFamily | String | "Lion Economy" | 去程票价舱/产品类型名称 |
| rtnFareFamily | String | "Lion Promo" | 回程票价舱/产品类型名称 |
| currency | String | "USD" | 币种编码，遵循 ISO 4217 标准（如 USD = 美元，CNY = 人民币） |
| adultFare | BigDecimal | 6115.00 | 去程成人票价（不含税） |
| rtnAdultFare | BigDecimal | 6100.00 | 回程成人票价（不含税） |
| adultTax | BigDecimal | 13714.00 | 去程成人税费 |
| rtnAdultTax | BigDecimal | 8540.00 | 回程成人税费 |
| childFare | BigDecimal | 0.00 | 去程儿童票价（不含税），儿童定义为 2-12 周岁 |
| rtnChildFare | BigDecimal | 0.00 | 回程儿童票价（不含税） |
| childTax | BigDecimal | 0.00 | 去程儿童税费 |
| rtnChildTax | BigDecimal | 0.00 | 回程儿童税费 |
| infantFare | BigDecimal | 0.00 | 去程婴儿票价（不含税），婴儿定义为 0-2 周岁（无独立座位） |
| rtnInfantFare | BigDecimal | 0.00 | 回程婴儿票价（不含税） |
| infantTax | BigDecimal | 0.00 | 去程婴儿税费 |
| rtnInfantTax | BigDecimal | 0.00 | 回程婴儿税费 |
| bookingCode | String | "Y,Y" | 去程舱位代码（如 Y、B、M、W 等），廉航领域不一定存在，可通过系统设置-参数设置-默认舱位编码指定默认值。 格式说明： - 单程直飞：单个代码，如 "Y"- 单程转机：逗号分隔多段，如 "B,Y" 表示第一段 B 舱，第二段 Y 舱 |
| rtnBookingCode | String | "Y,Y" | 回程舱位代码（如 Y、B、M、W 等），廉航领域不一定存在。 格式说明：同 bookingCode，单段为单个代码，多段用逗号分隔 |
| availableSeats | int | 7 | 去程剩余座位数 |
| rtnAvailableSeats | int | 2 | 回程剩余座位数 |
| flightPolicy | FlightPolicy | 去程航班政策（包含去程免费行李额、退改规则等） | |
| rtnFlightPolicy | FlightPolicy | 回程航班政策（包含回程免费行李额、退改规则等） |