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>
25 lines
2.9 KiB
Markdown
25 lines
2.9 KiB
Markdown
<!-- mipuyun-api-doc: passenger -->
|
||
# Passenger
|
||
|
||
# Passenger 实体定义
|
||
|
||
Passenger 实体用于描述航班预订中单个乘客的核心信息，包括身份信息、证件信息、常旅客信息及附加服务选择，是订单创建、值机办理等流程的关键数据依据。
|
||
|
||
| **字段名** | **数据类型** | **示例值** | **说明** |
|
||
| --- | --- | --- | --- |
|
||
| firstName | String | San | 乘客名，需与证件名完全一致，国际航司不可填入中文 |
|
||
| lastName | String | Zhang | 乘客姓，需与证件姓完全一致，国际航司不可填入中文 |
|
||
| passengerType | String | "ADT"、"CHD"、"INF" | 乘客类型，固定枚举值，用于区分票价规则与服务权益：- "ADT" = 成人（Adult，通常指 12 周岁及以上乘客）- "CHD" = 儿童（Child，通常指 2-11 周岁乘客，需单独购票，部分航司可享折扣）- "INF" = 婴儿（Infant，通常指 2 周岁以下乘客，需与成人乘客绑定预订，票价规则特殊） |
|
||
| dateOfBirth | String | "20251017" | 乘客出生日期，固定格式为 **YYYYMMDD**（如 "20180520" 表示 2018 年 5 月 20 日） |
|
||
| gender | String | "M"、"F" | 乘客性别，固定枚举值：- "M" = 男（Male）- "F" = 女（Female） |
|
||
| documentNumber | String | "E12345678" | 证件号码，需与证件类型（documentType）匹配 |
|
||
| documentType | String | "PP"、"ID" | 证件类型，固定枚举值，需与航司支持的证件类型一致：- "PP" = 护照（Passport），国际航班必填- "ID" = 身份证（Identity Card） |
|
||
| documentIssuePlace | String | "CN"、"US" | 证件签发国家 / 地区代码，遵循 **ISO 3166-1 alpha-2** 标准（2 位字母编码）：- "CN" = 中国内地- "US" = 美国 |
|
||
| documentExpirationDate | String | "20281030" | 证件有效期截止日期，固定格式为 **YYYYMMDD**（如 "20301231" 表示 2030 年 12 月 31 日），需满足 “有效期截止日期> 航班返程日期”（单程航班需满足 “> 出发日期”），否则会导致预订失败 |
|
||
| nationality | String | "CN"、"US" | 乘客国籍代码，遵循 **ISO 3166-1 alpha-2** 标准，与乘客护照 / 身份证上的国籍信息一致，用于航司核验出入境资格，不可为空 |
|
||
| mobile | String | 0086-13200112233 | 乘客手机号码注意格式采用xxxx-xxxxxxxxxxx前面4位为国家码。 |
|
||
| frequentFlyerCarrier | String | "CA"、"MU" | 常旅客所属航司代码，遵循 IATA 二字码标准，需与 ffpCardNo 对应的航司一致：- "CA" = 中国国际航空- "MU" = 中国东方航空无会员卡时填写 null，非必选 |
|
||
| frequentFlyerNumber | String | "CA1234567890" | 常旅客卡号（Frequent Flyer Program Card Number），即乘客在某航司的会员卡编号（如国航 “凤凰知音” 卡号 "CA1234567890"），无会员卡时填写 null，非必选 |
|
||
| ancillaries | Array | Ancillary | 复用shopping/baggage中的行李响应字段，详见 [Ancillary 实体定义](07-04_ancillary.md) |
|
||
|