diff --git a/changelogs-v2/2026-05/18_§2_traveler模块-新增接口-管理后台.md b/changelogs-v2/2026-05/18_§2_traveler模块-新增接口-管理后台.md index 17d765c..f45216d 100644 --- a/changelogs-v2/2026-05/18_§2_traveler模块-新增接口-管理后台.md +++ b/changelogs-v2/2026-05/18_§2_traveler模块-新增接口-管理后台.md @@ -36,10 +36,10 @@ | # | § | 接口名 | 方法 | 路径 | |---|---|--------|------|------| -| 1 | 2.1 | 出行人列表 | GET | `/v3/admin/order/{id}/travelers` | +| 1 | 2.1 | 出行人列表 | GET | `/v3/admin/order/{id}/traveler/list` | | 2 | 2.2 | 出行人批量编辑(upsert) | POST | `/v3/admin/order/{id}/traveler/batch-edit` | -| 3 | 2.3 | 单个出行人新增 | POST | `/v3/admin/order/{id}/travelers` | -| 4 | 2.4 | 出行人软删 | DELETE | `/v3/admin/order/{id}/travelers/{travelerId}` | +| 3 | 2.3 | 单个出行人新增 | POST | `/v3/admin/order/{id}/traveler/add` | +| 4 | 2.4 | 出行人软删 | POST | `/v3/admin/order/{id}/traveler/{travelerId}/delete` | | 5 | 2.6.1 | 大交通批次列表 | GET | `/v3/admin/order/{id}/transport-plans` | | 6 | 2.6.2 | 大交通批次新增 | POST | `/v3/admin/order/{id}/transport-plans` | | 7 | 2.6.3 | 大交通批次编辑 | PUT | `/v3/admin/order/{id}/transport-plans/{planId}` | @@ -60,7 +60,7 @@ ### 3.1 §2.1 出行人列表 -**路径**:`GET /v3/admin/order/{id}/travelers` +**路径**:`GET /v3/admin/order/{id}/traveler/list` **使用场景**:详情页 Tab 1 出行人区块 / F27 出行人补全页 **认证**:JWT(admin 角色 + 公司隔离) **敏感字段**:`idNo` / `phone` / `emergencyPhone` **明文返回**(admin JWT 鉴权保护) @@ -273,7 +273,7 @@ Content-Type: application/json ### 3.3 §2.3 单个出行人新增(占位补充) -**路径**:`POST /v3/admin/order/{id}/travelers` +**路径**:`POST /v3/admin/order/{id}/traveler/add` **使用场景**:F27 改人数场景(如临时加 1 个未声明儿童)。**会同步 UPDATE `order_main` 对应人数字段**(adultCount / childCount 等)+ 触发后续:保险重算 / 房车需求需重提示 #### 入参(`TravelerCreateReqVO`,12 字段) @@ -370,7 +370,7 @@ Content-Type: application/json ### 3.4 §2.4 出行人软删 -**路径**:`DELETE /v3/admin/order/{id}/travelers/{travelerId}` +**路径**:`POST /v3/admin/order/{id}/traveler/{travelerId}/delete` **使用场景**:F27 改人数场景(如取消同行 1 人) **关联**:同步 UPDATE `order_main` 对应人数 -1 + 解除其在 `order_transport_plan_traveler` 桥接表中所有关联 **约束**:**已签电子合同的订单禁止删人** @@ -407,7 +407,7 @@ Content-Type: application/json **典型 - 请求**: ```http -DELETE /v3/admin/order/60123456789012/travelers/70123456789013 +POST /v3/admin/order/60123456789012/traveler/70123456789013/delete Authorization: Bearer {admin_jwt} ```