提交

openspec/changes/zkxw-engineering-standards/specs/api-conventions/spec.md

@@ -46,7 +46,7 @@
 ```
 
 - `page`：页码，默认 `1`，从 1 开始
-- `pageSize`：每页条数，默认 `10`，最大 `100`
+- `pageSize`：每页条数，默认 `10`，最大 `500`
 - 筛选字段为可选，按业务需要定义
 - 排序字段暂不在请求体中定义，使用后端默认排序（`create_time DESC`），后续按需扩展
 
@@ -60,7 +60,7 @@
 }
 ```
 
-> **关键约束**：SHALL NOT 通过设置 `pageSize: 999`、`pageSize: 9999` 等大数值来模拟全量查询。这会导致后端参数校验 422 错误（pageSize 上限为 100）。需要全量数据时，必须调用不分页接口。
+> **关键约束**：SHALL NOT 通过设置 `pageSize: 999`、`pageSize: 9999` 等大数值来模拟全量查询。这会导致后端参数校验 422 错误（pageSize 上限为 500）。需要全量数据时，必须调用不分页接口。
 
 #### Scenario: 产品列表分页查询
 
@@ -80,12 +80,12 @@
 #### Scenario: 禁止超大 pageSize 模拟全量
 
 - **WHEN** 开发者需要获取全量数据
-- **THEN** SHALL NOT 设置 `pageSize: 999` / `pageSize: 9999` / `pageSize: 200` 等超过 100 的值
+- **THEN** SHALL NOT 设置 `pageSize: 999` / `pageSize: 9999` / `pageSize: 1000` 等超过 500 的值
 - **THEN** SHALL 使用对应的不分页接口（如 `/options`、`/tree`）
 
 #### Scenario: 后端 pageSize 校验
 
-- **WHEN** 后端分页接口接收到 `pageSize > 100`
+- **WHEN** 后端分页接口接收到 `pageSize > 500`
 - **THEN** SHALL 返回 422 参数校验错误，SHALL NOT 静默截断或放行
 
 #### 详情查询请求体