导入 Postman / Swagger：用 OpenAPI 文档管理印刷体OCR识别接口

# 导入 Postman / Swagger：用 OpenAPI 文档管理印刷体OCR识别接口 > 接口 926（接入点 926-1） · 免费 · POST/GET · JSON · 适用人群：注重 API 治理的团队 · 阅读时间：约 5 分钟 ## 核心要点 - 印刷体OCR识别提供标准 OpenAPI 3.0 文档，覆盖本接口全部接入点。 - 下载 YAML 后可导入 **Postman / Swagger UI / Swagger Editor**，自动生成请求模板与 Mock。 - 文档地址：`https://www.showapi.com/openapi/market/926.yaml`（YAML）与 `https://www.showapi.com/openapi/market/926.json`（JSON）。 > 本文使用 Postman / Swagger UI / Swagger Editor 演示；不使用其他 API 工具。 ## Why：把接口文档变成「可执行的资产」 手写调用代码容易漏参数、错字段。把官方 OpenAPI 文档导入工具，团队立刻拥有可调试的集合、可分享的 Mock、可校验的 Schema——新人也能照着发请求，协作成本低很多。 ## What：OpenAPI 资源 | 格式 | 地址 | 用途 | |------|------|------| | YAML | `https://www.showapi.com/openapi/market/926.yaml` | 导入 Postman / Swagger UI / Swagger Editor | | JSON | `https://www.showapi.com/openapi/market/926.json` | 程序化消费、AI Agent 读取 | 文档内容含：路径 `/926-1`（POST）、请求体字段（`img_base64`/`img_url`/`need_all_region`）、响应结构（`showapi_res_body` 及 `ret_code`/`str`/`remark`）、鉴权（query 参数 `appKey`）。 ## How：导入到工具 ### 方式 A：Swagger UI / Swagger Editor 1. 打开 [Swagger Editor](https://editor.swagger.io/)（在线版，或自建 Swagger UI）。 2. 左上「File → Import URL」，填入 `https://www.showapi.com/openapi/market/926.yaml`。 3. 文档加载后，展开 `POST /926-1`，点「Try it out」即可填参调试（把 `appKey` 换成你的真实密钥）。 ### 方式 B：Postman 1. 打开 Postman，新建请求集合。 2. 顶部「Import」→ 选择「Link」→ 粘贴 `https://www.showapi.com/openapi/market/926.yaml` → 确认导入。 3. 导入后自动生成带参数的请求；在 `appKey` query 与请求体填入你的数据即可发送。 **快速取文档（curl 验证可达）** ```bash curl -s -o 926.yaml "https://www.showapi.com/openapi/market/926.yaml" && head -n 5 926.yaml ``` ## 返回示例与解析 导入后工具会展示响应 Schema；实际返回结构同《返回字段全解》：成功 `ret_code=0`，取 `list`/`str`。 ## 进阶 / 边界 - **鉴权位置**：文档声明 `appKey` 为 query 参数，导入后在 URL 的 query 中填，而非 Header。 - **Mock 仅结构**：工具生成的 Mock 返回的是 Schema 样例，不是真实识别结果；真调用需填真实 `appKey` 与图片。 - **文档与页面一致性**：如前所述，OpenAPI 的响应 Schema 仅列 `ret_code/str/remark`，未含 `list` 字段（页面返回示例有 `list`）；以实际返回为准，必要时在工具里手动补 `list` 示例。 ## FAQ **Q1：导入后没有 need_all_region 参数？** A1：YAML 请求体已含 `need_all_region`，若工具未显示请确认导入的是最新 YAML（文档生成于 2026-08-26）；缺失可手动添加该字段。 **Q2：能用它生成代码吗？** A2：Postman/Swagger 支持「生成客户端代码」（多种语言），可基于导入的文档直接产出调用骨架。 **Q3：Mock 返回乱码/空？** A3：Mock 是结构占位，非真实识别；要真结果必须填真实 AppKey 与图片，走 live 请求。 **Q4：YAML 和 JSON 选哪个？** A4：二者内容一致；GUI 工具多用 YAML，程序/AI 消费可用 JSON。 ## 相关能力 / 下一步阅读 - [通过 MCP 协议在 AI 客户端中直接调用印刷体OCR识别](https://www.showapi.com/guides/printed-ocr-mcp-926) - [5 分钟接入印刷体OCR识别：从注册到第一条识别结果](https://www.showapi.com/guides/printed-ocr-quickstart-926) - [印刷体OCR识别返回字段全解：ret_code 与识别结果一文读懂](https://www.showapi.com/guides/printed-ocr-response-codes-926) - **本系列共 12 篇**：查看[印刷体OCR识别指南总目录](https://www.showapi.com/guides/printed-ocr-guides-926)