From edfffdf063866cf69816757b3951ac6026be5c72 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 1 Sep 2026 15:15:47 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=206905=20=E5=9B=A2=E6=9C=9F?= =?UTF-8?q?=E7=9C=8B=E6=9D=BF=204=20=E6=8E=A5=E5=8F=A3=E5=AF=B9=E9=BD=90?= =?UTF-8?q?=E8=A1=A5=E5=85=A8-=E9=80=90=E6=8E=A5=E5=8F=A3=E8=A7=84?= =?UTF-8?q?=E8=8C=83=E5=8C=96=20=E8=AF=B7=E6=B1=82/=E5=93=8D=E5=BA=94/?= =?UTF-8?q?=E7=A9=BA=E6=95=B0=E6=8D=AE/=E9=94=99=E8=AF=AF/=E4=B8=9A?= =?UTF-8?q?=E5=8A=A1=E8=BE=B9=E7=95=8C=20=E7=A4=BA=E4=BE=8B=E9=A1=BA?= =?UTF-8?q?=E5=BA=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...½�补全-GB-ADM-000-001-002-003-修改接口-管理后台.md | 73 ++++++++++++++----- 1 file changed, 54 insertions(+), 19 deletions(-) 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* 参数不传 = 不加载对应数据(零开销,向后兼容)。