diff --git a/changelogs-v2/2026-09/01_6905_团期看板-4-接口对齐补全-GB-ADM-000-001-002-003-修改接口-管理后台.md b/changelogs-v2/2026-09/01_6905_团期看板-4-接口对齐补全-GB-ADM-000-001-002-003-修改接口-管理后台.md index 4f7a9d59..9a3ad4af 100644 --- a/changelogs-v2/2026-09/01_6905_团期看板-4-接口对齐补全-GB-ADM-000-001-002-003-修改接口-管理后台.md +++ b/changelogs-v2/2026-09/01_6905_团期看板-4-接口对齐补全-GB-ADM-000-001-002-003-修改接口-管理后台.md @@ -85,6 +85,19 @@ GET /v3/admin/order/group-batch/products?productType=&keyword= } ``` +#### 空数据 / 降级响应 + +```json +{ + "code": 200, + "message": "成功", + "data": [] +} +``` + +- 无数据 → 空数组,不报错。 +- 未登录 → 401(网关拦截)。 + #### 错误响应 ```json @@ -95,11 +108,6 @@ GET /v3/admin/order/group-batch/products?productType=&keyword= } ``` -#### 空数据 / 降级响应 - -- 无数据 → 空数组,不报错。 -- 未登录 → 401(网关拦截)。 - #### 业务边界 - 未传筛选 = 不过滤,等价旧行为;regionText 为 null 时不阻断列表。 @@ -142,6 +150,22 @@ GET /v3/admin/order/group-batch?pageNo=1&pageSize=5&opsStage=FORMED&month=2026-0 } ``` +#### 空数据 / 降级响应 + +```json +{ + "code": 200, + "message": "成功", + "data": { + "records": [], + "total": 0 + } +} +``` + +- 无匹配 → records 空数组 total=0。 +- 排序保持 create_time DESC(向后兼容,未做排序变更)。 + #### 错误响应 ```json @@ -152,11 +176,6 @@ GET /v3/admin/order/group-batch?pageNo=1&pageSize=5&opsStage=FORMED&month=2026-0 } ``` -#### 空数据 / 降级响应 - -- 无匹配 → records 空数组 total=0。 -- 排序保持 create_time DESC(向后兼容,未做排序变更)。 - #### 业务边界 - opsStage 非法/未知 = 不过滤(保守向后兼容);month 格式非法 → 业务 400。 @@ -195,6 +214,18 @@ GET /v3/admin/order/group-batch/ } ``` +#### 空数据 / 降级响应 + +```json +{ + "code": 200, + "message": "成功", + "data": null +} +``` + +- 团期不存在 → 业务 404。 + #### 错误响应 ```json @@ -205,10 +236,6 @@ GET /v3/admin/order/group-batch/ } ``` -#### 空数据 / 降级响应 - -- 团期不存在 → 业务 404。 - #### 业务边界 - PRIMARY 报道人未配置时两 reporter 字段为 null,不降级不报错。 @@ -254,6 +281,19 @@ GET /v3/admin/order/group-batch//orders?includeTravelers=true&incl } ``` +#### 空数据 / 降级响应 + +```json +{ + "code": 200, + "message": "成功", + "data": [] +} +``` + +- 无子订单 → 空数组。 +- 证件号/游客手机号永不返回(数据安全边界)。 + #### 错误响应 ```json @@ -264,11 +304,6 @@ GET /v3/admin/order/group-batch//orders?includeTravelers=true&incl } ``` -#### 空数据 / 降级响应 - -- 无子订单 → 空数组。 -- 证件号/游客手机号永不返回(数据安全边界)。 - #### 业务边界 - include* 参数不传 = 不加载对应数据(零开销,向后兼容)。