docs: 药品目录分页契约同步 docs/07 与 openapi(T-211)

- docs/07 §8 pageNo 必填 + 补 pageSize + 分页说明 + 未联调警示
- openapi drugs 内联 pageNo(required)+pageSize,不动共享 pageNo
- tasks T-211 DONE

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ila
2026-07-09 22:22:55 +08:00
co-authored by Claude Opus 4.8
parent dc065a9c29
commit 7a079b2b3f
4 changed files with 29 additions and 6 deletions
+5 -3
View File
@@ -145,12 +145,14 @@ GET /api/dictionaries/drugs
| 参数 | 必填 | 说明 |
| --- | --- | --- |
| `pageNo` | **是** | 页码,整数——药品目录是**分页查询**,必填 |
| `pageSize` | 否 | 每页数量,整数 |
| `ypmc` | 否 | 药品名称关键字 |
| `pym` | 否 | 拼音码 |
| `pageNo` | 否 | 页码,整数 |
- 上游:`YPML00001` `/auto/ypmlcx/query`
- 返回:`data` 为**数组**(药品目录主数据,含 `ypmc`、`ypdw`、`ypgg`、`jldw` 等)
- 上游:`YPML00001` `/auto/ypmlcx/query`(**分页目录查询**,非按名单条)
- 返回:`data` 为**数组**(一页药品),每条含 `ypxh`(序号)/`ypmc`/`ypdw`/`ypgg`/`ypjl`(剂量)/`ycjl`(一次剂量)/`jldw` 等
- ⚠ 依 docx 契约,**YPML00001 尚未真实联调**:`pageNo` 是否真必填、`pageSize` 字段名、响应字段均以联调实测为准
### 9. 查询机构
+15 -2
View File
@@ -299,12 +299,25 @@ paths:
tags:
- dictionaries
summary: 查询药品目录
description: 查询药品目录主数据,原样返回上游 YPML00001 `/auto/ypmlcx/query` 响应。
description: 查询药品目录主数据(分页),原样返回上游 YPML00001 `/auto/ypmlcx/query` 响应。pageNo 必填;契约依 docx,尚未真实联调。
operationId: listDrugs
parameters:
- name: pageNo
in: query
required: true
description: 页码(药品目录为分页查询,必填)。
schema:
type: integer
minimum: 1
- name: pageSize
in: query
required: false
description: 每页数量。
schema:
type: integer
minimum: 1
- $ref: '#/components/parameters/ypmc'
- $ref: '#/components/parameters/pym'
- $ref: '#/components/parameters/pageNo'
responses:
'200':
description: 平台完整响应,成功和平台业务错误均原样透传。