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>
77 lines
2.2 KiB
Markdown
77 lines
2.2 KiB
Markdown
<!-- mipuyun-api-doc: itinerary -->
|
||
# Itinerary - 行程实体对象
|
||
|
||
Itinerary 实体（行程组合信息，与实际响应字段一致）
|
||
|
||
| **参数名称** | **类型** | **说明** |
|
||
| --- | --- | --- |
|
||
| outboundSegments | Array<[SegmentElement](08-03_segment-element.md)> | 去程航段列表：单程（OW）和往返（RT）场景均返回，按行程顺序排列 |
|
||
| inboundSegments | Array<[SegmentElement](08-03_segment-element.md)> | 返程航段列表：仅往返（RT）场景返回，字段含义同 outboundSegments；单程（OW）场景为空数组 |
|
||
| fares | Array<[FlightFare](08-02_flight-fare.md)> | 该行程下的可选票价方案列表，每个方案包含去程/回程的票价、税费、座位数、舱位类型及航班政策信息 |
|
||
|
||
## 实体轮廓
|
||
|
||
```json
|
||
{
|
||
"outboundSegments": [
|
||
{
|
||
"index": 1,
|
||
"carrier": "VJ",
|
||
"flightNumber": "VJ884",
|
||
"operatingCarrier": "",
|
||
"operatingFlightnumber": "",
|
||
"originAirport": "BOM",
|
||
"destinationAirport": "SGN",
|
||
"departureTime": "202510270040",
|
||
"arrivalTime": "202510270705",
|
||
"departureTerminal": "",
|
||
"arrivalTerminal": "",
|
||
"stopCities": "",
|
||
"duration": 295,
|
||
"aircraftCode": "330",
|
||
"codeShare": false
|
||
}
|
||
],
|
||
"inboundSegments": [
|
||
{
|
||
// 同 outboundSegments 结构
|
||
}
|
||
],
|
||
"fares": [
|
||
{
|
||
"fareBasis": "",
|
||
"rtnFareBasis": "",
|
||
"fareFamily": "Lion Economy",
|
||
"rtnFareFamily": "Lion Promo",
|
||
"currency": "USD",
|
||
"bookingCode": "Y,Y",
|
||
"rtnBookingCode": "Y,Y",
|
||
"availableSeats": 7,
|
||
"rtnAvailableSeats": 2,
|
||
"flightPolicy": {
|
||
"airlineCode": "SL",
|
||
"fareFamilyType": "Lion Economy",
|
||
"description": "",
|
||
"freeAncillaryList": [
|
||
{
|
||
"categoryCode": "CabinBaggageOverheadLocker",
|
||
"segmentIndex": 1,
|
||
"paxType": "ADT",
|
||
"piece": 1,
|
||
"weight": 7,
|
||
"size": ""
|
||
}
|
||
],
|
||
"refundRules": [], // 预留字段，暂未提供
|
||
"changeRules": [] // 预留字段，暂未提供
|
||
},
|
||
"rtnFlightPolicy": {
|
||
// 同 flightPolicy 结构
|
||
}
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
> `RuleElement` 结构详见 [FlightPolicy](08-04_flight-policy.md)
|