45 行
1.9 KiB
Markdown
45 行
1.9 KiB
Markdown
# 【修改接口·小程序端】到达计划自驾时段 selfDrivePeriodLabel 文案口径含时间范围
|
||
|
||
> **PR**: #4061 | **服务**: hl-order-service-v3（经 mp-service 透传）| **更新时间**: 2026-06-19
|
||
|
||
## 1. 接口背景
|
||
|
||
大交通枚举改造（#4061）统一了自驾时段 `SelfDrivePeriod` 枚举的中文 label 口径，含时间范围。到达计划（mp）出参 `ArrivalPlanRespVO.selfDrivePeriodLabel` 随之变化。前端直接显示该 label，**无需改代码**，只是显示文案更详细了。
|
||
|
||
## 2. 变更清单
|
||
|
||
| 接口 | 方法 | 路径 | 变更 |
|
||
|---|---|---|---|
|
||
| 到达计划查询 | GET | /v3/internal/mp/order/arrival/{orderId} | 出参 selfDrivePeriodLabel 文案口径变化 |
|
||
|
||
（同枚举也用于 mp 创建/更新/批量接口的回显出参）
|
||
|
||
## 3. 出参变化
|
||
|
||
| 字段 | 类型 | 变更 | 说明 |
|
||
|---|---|---|---|
|
||
| selfDrivePeriodLabel | String | 文案口径调整 | 自驾时段中文，由「上午/下午/晚上」改为含时间范围 |
|
||
|
||
## 4. 枚举 / 数据字典
|
||
|
||
| selfDrivePeriod 码值 | 改前 label | 改后 label |
|
||
|---|---|---|
|
||
| MORNING | 上午 | **上午(06:00-12:00)** |
|
||
| AFTERNOON | 下午 | **下午(12:00-18:00)** |
|
||
| EVENING | 晚上 | **晚上(18:00-24:00)** |
|
||
|
||
## 5. 影响评估
|
||
|
||
- **破坏向后兼容**：否。`selfDrivePeriod` 码值不变，仅 `selfDrivePeriodLabel` 展示文案更详细。
|
||
- **前端是否需改**：否，前端直接展示 label 即可（显示内容自动变详细）。**例外**：若前端有按 label 文案做精确匹配/判断的逻辑（不推荐），需改为按 `selfDrivePeriod` 码值判断。
|
||
|
||
## 6. 注意事项
|
||
|
||
- 自驾时段判断逻辑请用 `selfDrivePeriod` 码值（MORNING/AFTERNOON/EVENING），不要依赖 `selfDrivePeriodLabel` 文案。
|
||
|
||
## 7. 关联 / 联系人
|
||
|
||
- **Issue**: [#4058](https://git.1814.love:8443/wx/HL/issues/4058)
|
||
- **PR**: [#4061](https://git.1814.love:8443/wx/HL/pulls/4061)
|
||
- **后端负责人**: @yaosutu
|