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:
@@ -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
@@ -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: 平台完整响应,成功和平台业务错误均原样透传。
|
||||
|
||||
Reference in New Issue
Block a user