98 行
2.4 KiB
Markdown
98 行
2.4 KiB
Markdown
# 新增：获取订单出行人接口
|
||
|
||
**日期**: 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_type）ID_CARD/PASSPORT/OTHER |
|
||
| idCardNo | String | 证件号码 |
|
||
| phone | String | 手机号（可能为null） |
|
||
| gender | Integer | 性别（字典：gender）1=男 0=女 |
|
||
| birthday | String | 出生日期 yyyy-MM-dd |
|
||
| travelerType | String | 出行人类型（字典：traveler_type）ADULT/CHILD/BABY |
|
||
| nationality | String | 国籍 |
|
||
| emergencyContact | String | 紧急联系人 |
|
||
| emergencyPhone | String | 紧急联系电话 |
|
||
|
||
---
|
||
|
||
## 使用场景
|
||
|
||
### 保险投保页面 - 自动填充被保人
|
||
|
||
1. 用户输入关联订单ID
|
||
2. 调用 `GET /admin/order/{orderId}/travelers` 获取出行人列表
|
||
3. 将出行人信息映射为被保人（姓名、证件号、性别、生日）
|
||
4. 自动填充到被保人列表，无需手动添加
|
||
|
||
### 字段映射（出行人 → 被保人）
|
||
|
||
| 出行人字段 | 被保人字段 |
|
||
|-----------|-----------|
|
||
| name | name |
|
||
| idCardType | idCardType |
|
||
| idCardNo | idCardNo |
|
||
| gender（1=男→MALE, 0=女→FEMALE） | gender |
|
||
| birthday | birthday |
|
||
| phone | phone |
|