导入 Postman / Swagger：用 OpenAPI 文档管理药品信息查询接口

# 导入 Postman / Swagger：用 OpenAPI 文档管理药品信息查询接口 - **接口/接入点**：药品信息查询（apiCode=1468）· OpenAPI 3.0 文档（接口级，覆盖全部接入点） - **是否免费**：免费（有档位限制） - **请求方式**：POST / GET - **返回格式**：JSON - **适用人群**：注重 API 治理的团队、后端工程师 - **阅读时间**：约 4 分钟 ## 核心要点 - ShowAPI 为药品信息查询提供了标准 **OpenAPI 3.0** 文档（YAML/JSON），覆盖全部接入点，可直接导入 API 工具。 - 导入后可自动生成请求模板与 Mock 数据，便于团队协作、文档沉淀与Mock 联调。 - 可用 **Postman / Swagger UI / Swagger Editor** 导入（本文不涉及其他工具）。 ## Why：为什么用 OpenAPI 管理 团队接多个接口时，一份机器可读的 OpenAPI 文档能让「写代码、出文档、做 Mock」三件事统一，减少参数沟通成本，也方便接入网关或代码生成。 ## What：文档资源 | 项 | 地址 | |------|------| | OpenAPI YAML（在线/下载） | `https://www.showapi.com/openapi/market/1468.yaml` | | OpenAPI JSON | `https://www.showapi.com/openapi/market/1468.json` | | 覆盖范围 | 1468-1 / 1468-2 / 1468-3 / 1468-4 | ## How：导入到 API 工具 ### 导入 Postman 1. 打开 Postman → Import → 粘贴或上传 `1468.yaml`。 2. 导入后每个接入点生成独立请求，把 `appKey` 参数填为你的 `YOUR_APPKEY`。 3. 用「Examples / Mock Server」生成 Mock 联调。 ### 用 Swagger UI / Swagger Editor 查看 1. 打开 Swagger Editor，粘贴 YAML 内容即可渲染交互式文档。 2. 或部署 Swagger UI 指向 `1468.yaml`，团队共享同一份接口说明。 ```bash # 直接下载文档备用 curl -O "https://www.showapi.com/openapi/market/1468.yaml" ``` ## 返回示例与解析 OpenAPI 文档中的 `parameters` 与 `responses` 与官网一致：鉴权为 `appKey` query 参数，业务数据位于 `showapi_res_body`。用它生成的请求模板可直接发到 `https://route.showapi.com/1468-x`。 ## 进阶 / 边界 - 文档覆盖全部接入点，但各接入点参数差异（如 1468-2 的 classifyId 必填、1468-3 的 searchType）仍需按业务处理。 - 团队内部可基于该 YAML 做二次加工（如补 `servers`、示例值），再提交代码仓库统一管理。 ## FAQ **Q1：OpenAPI 文档和官网参数不一致以谁为准？** A：以官网接口页与真实返回为准；文档用于快速生成模板，发现出入时以接口实际行为校正。 **Q2：能生成代码吗？** A：OpenAPI 3.0 可被多种代码生成器消费（如 openapi-generator），生成各语言客户端骨架，再补 AppKey 鉴权即可。 **Q3：Mock 数据准吗？** A：Mock 基于文档 schema 生成，用于联调占位；真实字段值与枚举以实际接口返回为准。 ## 相关能力 / 下一步阅读 - [通过 MCP 协议在 AI 客户端中直接查询药品信息](https://www.showapi.com/guides/drug-info-mcp-1468) - [药品信息查询返回字段全解](https://www.showapi.com/guides/drug-info-fields-1468) - [药品信息查询：5 分钟快速接入指南](https://www.showapi.com/guides/drug-info-quickstart-1468) - **本系列共 11 篇**：查看[药品信息查询指南总目录](https://www.showapi.com/guides/drug-info-guides-1468)