hl-api-changelog/changelogs/2026-03/2026-03-21_order_travelers_api.md

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

日期: 2026-03-21 服务: hl-order-service 类型: 新增接口

---

功能说明

新增管理端独立获取订单出行人接口，用于保险投保页面自动填充被保人信息。

---

接口清单

方法	路径	说明
GET	/admin/order/{orderId}/travelers	获取指定订单的出行人列表

---

详细定义

GET /admin/order/{orderId}/travelers

请求参数

参数	位置	类型	必填	说明
orderId	path	Long	是	订单ID

响应示例

{
  "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