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>
7.8 KiB
7.8 KiB
feeItems 实体定义
该实体用于拆分航班预订费用，字段与最新响应数据完全对齐，同时补充业务含义说明：
字段结构
feeItems
├── amount (总金额)
├── currency (货币代码)
├── fare (票价)
│ ├── amount (票价总金额)
│ ├── name (费用名称)
│ ├── remark (费用备注)
│ └── passengers (按乘机人拆分)
│ └── 每个乘客的票价明细
├── tax (税费)
│ ├── amount (税费总金额)
│ ├── name (费用名称)
│ ├── remark (费用备注)
│ ├── passengers (按乘机人拆分)
│ │ └── 每个乘客的税费明细
│ │ └── fees (税费细项)
│ │ └── 每个税费的明细
│ └── fees (税费总细项)
│ └── 每个税费的明细
├── cabinBaggage (手提行李)
│ ├── amount (手提行李总金额)
│ ├── name (费用名称)
│ ├── remark (费用备注)
│ └── passengers (按乘机人拆分)
│ └── 每个乘客的手提行李费用明细
├── checkedBaggage (托运行李)
│ ├── amount (托运行李总金额)
│ ├── name (费用名称)
│ ├── remark (费用备注)
│ └── passengers (按乘机人拆分)
│ └── 每个乘客的托运行李费用明细
├── seat (座位)
│ ├── amount (座位总金额)
│ ├── name (费用名称)
│ ├── remark (费用备注)
│ └── passengers (按乘机人拆分)
│ └── 每个乘客的座位费用明细
├── payment (支付手续费)
│ ├── amount (支付手续费总金额)
│ ├── name (费用名称)
│ └── remark (费用备注)
└── other (其他额外费用)
├── amount (其他额外费用总金额)
├── name (费用名称)
| 字段名 | 数据类型 | 示例值 | 说明 |
|---|---|---|---|
| totalPrice | Decimal | "850.00" | 总金额：航班预订的全部费用合计，单位与 currency 一致 |
| currency | String | "CNY" | 货币代码：标识费用的货币类型（如 CNY 为人民币、USD 为美元） |
| ticketPrice | Object | {"amount":"200.00","name":"票价",...} | 票价对象：包含票价总金额、费用名称、备注及可选的乘机人拆分明细（PassengerFee 数组） |
| tax | Object | {"amount":"250.00","name":"税",...} | 税费对象：包含税费总金额、费用名称、备注，可选乘机人拆分明细（PassengerFee 数组）和税费细项（FeeDetail 数组） |
| cabinBaggage | Object | {"amount":"50.00","name":"手提行李",...} | 手提行李费用对象：包含总金额、费用名称、备注及可选的乘机人拆分明细（PassengerFee 数组），可选字段 |
| checkedBaggage | Object | {"amount":"150.00","name":"托运行李",...} | 托运行李费用对象：包含总金额、费用名称、备注及可选的乘机人拆分明细（PassengerFee 数组），可选字段 |
| seat | Object | {"amount":"100.00","name":"座位",...} | 座位费用对象：包含总金额、费用名称、备注及可选的乘机人拆分明细（PassengerFee 数组），可选字段 |
| payment | Object | {"amount":"50.00","name":"支付手续费",...} | 支付手续费对象：包含总金额、费用名称、备注，无乘机人拆分，可选字段 |
| other | Object | {"amount":"0.00","name":"其他费用",...} | 其他额外费用对象：包含总金额、费用名称、备注，无乘机人拆分，可选字段 |
嵌套实体定义
PassengerFee（乘机人费用明细）
| 字段名 | 数据类型 | 示例值 | 说明 |
|---|---|---|---|
| amount | Decimal | "100.00" | 乘机人对应费用金额：单个乘客在该费用类型下的应付金额 |
| name | String | "willow/yang" | 乘机人姓名：对应乘客的姓名标识 |
| remark | String | "成人票价" | 备注：说明该乘客费用的相关信息（如乘客类型、费用用途） |
| fees | Array[FeeDetail] | [{"amount":"100.00","name":"机场税",...}] | 税费细项数组：仅税费对象的乘机人明细中可选，包含该乘客的具体税费拆分，可选字段 |
FeeDetail（费用细项明细）
| 字段名 | 数据类型 | 示例值 | 说明 |
|---|---|---|---|
| amount | Decimal | "170.00" | 细项金额：单个费用细项的总金额或乘机人对应金额 |
| name | String | "机场税" | 细项名称：描述费用细项的类型（如机场税、燃油附加费） |
| remark | String | "机场税" | 备注：补充说明费用细项的相关信息，与名称语义一致 |
| code | String | - | 费用细项编码：唯一标识该费用细项类型，可选字段 |
响应示例
{
"success": true,
"feeItems": {
"totalPrice": "850.00",
"currency": "CNY",
"ticketPrice": {
"amount": "200.00",
"name": "票价",
"remark": "票价",
"passengers": [
{
"amount": "100.00",
"name": "willow/yang",
"remark": "成人票价"
},
{
"amount": "100.00",
"name": "jasen/yang",
"remark": "成人票价"
}
]
},
"tax": {
"amount": "250.00",
"name": "税",
"remark": "税费",
"passengers": [
{
"amount": "150.00",
"name": "willow/yang",
"remark": "成人税价",
"fees": [
{
"amount": "100.00",
"name": "机场税",
"remark": "机场税"
},
{
"amount": "50.00",
"name": "燃油附加费",
"remark": "燃油附加费"
}
]
},
{
"amount": "100.00",
"name": "jasen/yang",
"remark": "成人税价",
"fees": [
{
"amount": "70.00",
"name": "机场税",
"remark": "机场税"
},
{
"amount": "30.00",
"name": "燃油附加费",
"remark": "燃油附加费"
}
]
}
],
"fees": [
{
"amount": "170.00",
"name": "机场税",
"remark": "机场税"
},
{
"amount": "80.00",
"name": "燃油附加费",
"remark": "燃油附加费"
}
]
},
"cabinBaggage": {
"amount": "50.00",
"name": "手提行李",
"remark": "手提行李费",
"passengers": [
{
"amount": "25.00",
"name": "willow/yang",
"remark": "手提行李费"
},
{
"amount": "25.00",
"name": "jasen/yang",
"remark": "手提行李费"
}
]
},
"checkedBaggage": {
"amount": "150.00",
"name": "托运行李",
"remark": "托运行李费",
"passengers": [
{
"amount": "75.00",
"name": "willow/yang",
"remark": "托运行李费"
},
{
"amount": "75.00",
"name": "jasen/yang",
"remark": "托运行李费"
}
]
},
"seat": {
"amount": "100.00",
"name": "座位",
"remark": "选座费",
"passengers": [
{
"amount": "50.00",
"name": "willow/yang",
"remark": "选座费"
},
{
"amount": "50.00",
"name": "jasen/yang",
"remark": "选座费"
}
]
},
"payment": {
"amount": "50.00",
"name": "支付手续费",
"remark": "支付手续费"
},
"other": {
"amount": "0.00",
"name": "其他费用",
"remark": "其他费用"
}
}
}