Files

杨柳杰 b450b512a2 init: mipu-open 对外开放项目统一管理仓库

- 添加 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>

2026-05-04 12:16:08 +08:00

2.9 KiB

Raw Blame History

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 实体定义

2.9 KiB Raw Blame History Unescape Escape

Passenger

Passenger 实体定义

2.9 KiB

Raw Blame History