新增接口:GET /admin/order/{orderId}/travelers 获取订单出行人
这个提交包含在:
父节点
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_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 |
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户