hl-api-changelog/changelogs/2026-03/2026-03-24_traveler_gender_string.md

出行人性别字段类型变更：Integer → String（匹配字典）

日期：2026-03-24 影响范围：小程序出行人模块、订单出行人模块 关联字典：gender

变更说明

出行人相关接口的 gender 字段从 Integer 改为 String，与字典 gender 的 dict_value 保持一致。

之前：gender 返回 Integer（如 1），前端用字典匹配时类型不一致导致报错 现在：gender 返回 String（如 "1"），可直接与字典 dict_value 匹配

字典值对照

dict_value (String)	dict_label	说明
"1"	男	—
"2"	女	—

受影响接口

小程序 - 出行人接口

接口	方法	路径
添加出行人	POST	/mp/user/traveler
出行人列表	GET	/mp/user/traveler
出行人详情	GET	/mp/user/traveler/{id}
更新出行人	PUT	/mp/user/traveler/{id}

请求参数变更：

{
  "gender": "1"    // 之前是 Integer 1，现在是 String "1"
}

响应字段变更：

{
  "gender": "1"    // 之前是 Integer 1，现在是 String "1"
}

订单 - 创建订单（出行人信息）

接口	方法	路径
创建订单	POST	/mp/order

travelers 数组中的 gender 字段：

{
  "travelers": [
    {
      "name": "张三",
      "gender": "1",    // String，不再是 Integer
      "idCardType": "ID_CARD",
      "idCardNo": "110101199001011234"
    }
  ]
}

前端适配要点

1. 提交时：gender 传 String 类型（"1" 或 "2"），不要传 Integer
2. 展示时：返回值已经是 String，可直接用字典 dict_value 匹配显示中文标签
3. 编辑回显：gender 是 String，选择器绑定值直接用即可，无需类型转换