新增接口:GET /admin/order/{orderId}/travelers 获取订单出行人

这个提交包含在:
API Changelog Bot 2026-03-21 09:12:07 +08:00
父节点 fe46bec807
当前提交 00cfbeb0e4

查看文件

@ -0,0 +1,97 @@
# 新增:获取订单出行人接口
**日期**: 2026-03-21
**服务**: hl-order-service
**类型**: 新增接口
---
## 功能说明
新增管理端独立获取订单出行人接口,用于保险投保页面自动填充被保人信息。
---
## 接口清单
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /admin/order/{orderId}/travelers | 获取指定订单的出行人列表 |
---
## 详细定义
### GET /admin/order/{orderId}/travelers
#### 请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|------|------|------|------|------|
| orderId | path | Long | 是 | 订单ID |
#### 响应示例
```json
{
"code": 200,
"message": "成功",
"data": [
{
"orderTravelerId": "2034962583668371457",
"orderId": "2034961514288623617",
"name": "张三",
"idCardType": "ID_CARD",
"idCardNo": "152125199101022016",
"phone": "13800138000",
"gender": 1,
"birthday": "1991-01-02",
"travelerType": "ADULT",
"nationality": "中国",
"emergencyContact": "李四",
"emergencyPhone": "13800138001",
"email": null,
"createTime": "2026-03-20 19:57:42"
}
]
}
```
#### 响应字段说明
| 字段 | 类型 | 说明 |
|------|------|------|
| orderTravelerId | String | 出行人ID |
| orderId | String | 订单ID |
| name | String | 姓名 |
| idCardType | String | 证件类型字典id_card_typeID_CARD/PASSPORT/OTHER |
| idCardNo | String | 证件号码 |
| phone | String | 手机号可能为null |
| gender | Integer | 性别字典gender1=男 0=女 |
| birthday | String | 出生日期 yyyy-MM-dd |
| travelerType | String | 出行人类型字典traveler_typeADULT/CHILD/BABY |
| nationality | String | 国籍 |
| emergencyContact | String | 紧急联系人 |
| emergencyPhone | String | 紧急联系电话 |
---
## 使用场景
### 保险投保页面 - 自动填充被保人
1. 用户输入关联订单ID
2. 调用 `GET /admin/order/{orderId}/travelers` 获取出行人列表
3. 将出行人信息映射为被保人(姓名、证件号、性别、生日)
4. 自动填充到被保人列表,无需手动添加
### 字段映射(出行人 → 被保人)
| 出行人字段 | 被保人字段 |
|-----------|-----------|
| name | name |
| idCardType | idCardType |
| idCardNo | idCardNo |
| gender1=男→MALE, 0=女→FEMALE | gender |
| birthday | birthday |
| phone | phone |