导入 Postman / Swagger：用 OpenAPI 文档管理图书ISBN查询接口

# 导入 Postman / Swagger：用 OpenAPI 文档管理图书ISBN查询接口 > 接口/接入点：图书ISBN查询（1626-1） · 是否免费：免费 · 集成方式：OpenAPI 3.0（接口级） · 适用人群：API 治理团队、开发者 · 阅读时间：约 5 分钟 ## TL;DR - 图书ISBN查询提供标准 OpenAPI 3.0 文档（覆盖全部接入点），可下载 YAML / JSON。 - 导入 **Postman** 或 **Swagger UI** 即可自动生成请求模板与 Mock，方便调试与团队协作。 - 文档地址：`https://www.showapi.com/openapi/market/1626.yaml`（在线/下载）、`https://www.showapi.com/openapi/market/1626.json`。 ## Why 团队接接口，最怕"每个人手敲一份请求、参数各写各的"。一份 OpenAPI 文档统一了接口契约：导入 Postman 出可调用的请求集合，导入 Swagger UI 出可交互文档，还能生成 Mock 给前端并行开发。治理成本一下子降下来。 ## What | 项 | 说明 | |----|------| | 文档标准 | OpenAPI 3.0（接口级，覆盖全部接入点） | | YAML | https://www.showapi.com/openapi/market/1626.yaml | | JSON | https://www.showapi.com/openapi/market/1626.json | | 推荐工具 | Postman、Swagger UI、Swagger Editor（用于查看/校验） | ## How ### 步骤 1：下载 OpenAPI 文档 ```bash curl -O https://www.showapi.com/openapi/market/1626.yaml # 或 JSON curl -O https://www.showapi.com/openapi/market/1626.json ``` ### 步骤 2：导入 Postman 1. 打开 Postman → Import → 选择下载的 `1626.yaml`。 2. Postman 自动生成该接口的请求集合（含路径、参数、示例）。 3. 在请求里把 `appKey` 设为你的真实 AppKey（或 Postman 环境变量），即可发送。 ### 步骤 3：用 Swagger UI 查看可交互文档 1. 打开 Swagger UI（自托管或官方编辑器）。 2. File → Import URL，填入 `https://www.showapi.com/openapi/market/1626.yaml`。 3. 在页面内直接填 `isbn` 试调，查看请求/响应结构。 ### 步骤 4（可选）：生成 Mock 给前端 在 Postman 或 Swagger 生态中基于该文档生成 Mock Server，前端无需等待真实接口即可联调。 ## 返回示例与解析 OpenAPI 文档描述了完整的请求参数（`isbn` 等）与响应结构（`showapi_res_body` 内的 `ret_code`/`data` 等），与本文系列其他篇的字段说明一致。 ## 进阶 / 边界 - **文档即契约**：以官方 OpenAPI 为准，团队统一从这里导入，避免手敲偏差。 - **AppKey 管理**：在 Postman 用环境变量管理 AppKey，不要硬编码进共享文档。 - **AI 可消费**：OpenAPI 文档也可供 AI Agent 直接读取，用于自动生成调用代码。 ## FAQ **Q1：文档能导入哪些工具？** 标准 OpenAPI 3.0，可导入 Postman、Swagger UI、Swagger Editor 等兼容工具。 **Q2：YAML 和 JSON 选哪个？** 内容一致，二选一即可；Postman 对 YAML/JSON 都支持。 **Q3：导入后怎么快速试调？** 在 Postman 填好 `appKey` 与 `isbn` 直接 Send；Swagger UI 内也可在线试调。 **Q4：文档覆盖所有接入点吗？** 覆盖本接口全部接入点；本接口当前仅 1 个接入点（1626-1）。 ## 相关能力 / 下一步阅读 - [通过 MCP 协议在 Cherry Studio / ChatBox 中直接用图书ISBN查询查书](https://www.showapi.com/guides/isbn-book-mcp-1626) - [图书ISBN查询：5 分钟接入，从注册到第一条图书信息](https://www.showapi.com/guides/isbn-book-quickstart-1626) - [图书ISBN查询返回字段全解：一本书的 13 个元数据字段一文读懂](https://www.showapi.com/guides/isbn-book-fields-explained-1626) - **本系列共 12 篇**：查看[图书ISBN查询（apiCode=1626）官方指南总目录](https://www.showapi.com/guides/isbn-book-guides-1626)