出行人gender字段类型变更:Integer → String(匹配字典)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
这个提交包含在:
父节点
bc8ab5e188
当前提交
252607cf89
@ -0,0 +1,70 @@
|
|||||||
|
# 出行人性别字段类型变更: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}` |
|
||||||
|
|
||||||
|
**请求参数变更**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"gender": "1" // 之前是 Integer 1,现在是 String "1"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**响应字段变更**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"gender": "1" // 之前是 Integer 1,现在是 String "1"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 订单 - 创建订单(出行人信息)
|
||||||
|
|
||||||
|
| 接口 | 方法 | 路径 |
|
||||||
|
|------|------|------|
|
||||||
|
| 创建订单 | POST | `/mp/order` |
|
||||||
|
|
||||||
|
**travelers 数组中的 gender 字段**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"travelers": [
|
||||||
|
{
|
||||||
|
"name": "张三",
|
||||||
|
"gender": "1", // String,不再是 Integer
|
||||||
|
"idCardType": "ID_CARD",
|
||||||
|
"idCardNo": "110101199001011234"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 前端适配要点
|
||||||
|
|
||||||
|
1. **提交时**:`gender` 传 String 类型(`"1"` 或 `"2"`),不要传 Integer
|
||||||
|
2. **展示时**:返回值已经是 String,可直接用字典 `dict_value` 匹配显示中文标签
|
||||||
|
3. **编辑回显**:`gender` 是 String,选择器绑定值直接用即可,无需类型转换
|
||||||
正在加载...
x
在新工单中引用
屏蔽一个用户