docs(changelog): 6905 团期看板 4 接口对齐补全-逐接口规范化 请求/响应/空数据/错误/业务边界 示例顺序
这个提交包含在:
@@ -85,6 +85,19 @@ GET /v3/admin/order/group-batch/products?productType=&keyword=
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### 空数据 / 降级响应
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"message": "成功",
|
||||||
|
"data": []
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- 无数据 → 空数组,不报错。
|
||||||
|
- 未登录 → 401(网关拦截)。
|
||||||
|
|
||||||
#### 错误响应
|
#### 错误响应
|
||||||
|
|
||||||
```json
|
```json
|
||||||
@@ -95,11 +108,6 @@ GET /v3/admin/order/group-batch/products?productType=&keyword=
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 空数据 / 降级响应
|
|
||||||
|
|
||||||
- 无数据 → 空数组,不报错。
|
|
||||||
- 未登录 → 401(网关拦截)。
|
|
||||||
|
|
||||||
#### 业务边界
|
#### 业务边界
|
||||||
|
|
||||||
- 未传筛选 = 不过滤,等价旧行为;regionText 为 null 时不阻断列表。
|
- 未传筛选 = 不过滤,等价旧行为;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
|
```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。
|
- opsStage 非法/未知 = 不过滤(保守向后兼容);month 格式非法 → 业务 400。
|
||||||
@@ -195,6 +214,18 @@ GET /v3/admin/order/group-batch/<groupBatchId>
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### 空数据 / 降级响应
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"message": "成功",
|
||||||
|
"data": null
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- 团期不存在 → 业务 404。
|
||||||
|
|
||||||
#### 错误响应
|
#### 错误响应
|
||||||
|
|
||||||
```json
|
```json
|
||||||
@@ -205,10 +236,6 @@ GET /v3/admin/order/group-batch/<groupBatchId>
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 空数据 / 降级响应
|
|
||||||
|
|
||||||
- 团期不存在 → 业务 404。
|
|
||||||
|
|
||||||
#### 业务边界
|
#### 业务边界
|
||||||
|
|
||||||
- PRIMARY 报道人未配置时两 reporter 字段为 null,不降级不报错。
|
- PRIMARY 报道人未配置时两 reporter 字段为 null,不降级不报错。
|
||||||
@@ -254,6 +281,19 @@ GET /v3/admin/order/group-batch/<groupBatchId>/orders?includeTravelers=true&incl
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### 空数据 / 降级响应
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"message": "成功",
|
||||||
|
"data": []
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- 无子订单 → 空数组。
|
||||||
|
- 证件号/游客手机号永不返回(数据安全边界)。
|
||||||
|
|
||||||
#### 错误响应
|
#### 错误响应
|
||||||
|
|
||||||
```json
|
```json
|
||||||
@@ -264,11 +304,6 @@ GET /v3/admin/order/group-batch/<groupBatchId>/orders?includeTravelers=true&incl
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 空数据 / 降级响应
|
|
||||||
|
|
||||||
- 无子订单 → 空数组。
|
|
||||||
- 证件号/游客手机号永不返回(数据安全边界)。
|
|
||||||
|
|
||||||
#### 业务边界
|
#### 业务边界
|
||||||
|
|
||||||
- include* 参数不传 = 不加载对应数据(零开销,向后兼容)。
|
- include* 参数不传 = 不加载对应数据(零开销,向后兼容)。
|
||||||
|
|||||||
在新工单中引用
屏蔽一个用户