# 新增：获取订单出行人接口

**日期**: 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 |