导入 Postman / Swagger：用 OpenAPI 文档管理条码接口

# 导入 Postman / Swagger：用 OpenAPI 文档管理条码接口 > 接口/接入点：条码生成与识别（apiCode 1129）· OpenAPI 3.0 文档（覆盖全部接入点）｜ 是否免费：免费 ｜ 适用人群：API 治理/后端团队 ｜ 阅读时间：约 5 分钟 ## TL;DR - ShowAPI 提供标准 OpenAPI 3.0 文档（YAML/JSON），覆盖全部 4 个接入点。 - 下载后导入 **Postman** 或 **Swagger UI / Swagger Editor**，自动生成请求模板与 Mock。 - 用于团队 API 治理、契约管理与 AI Agent 直接消费；**禁用 Apifox**。 ## Why：用 OpenAPI 管理接口资产 当条码能力要被多个团队/服务调用，散落的 curl 片段会变成维护负担。一份 OpenAPI 文档能作为"契约"：导入 Postman 给测试同学、导入 Swagger UI 给前端联调、交给 AI Agent 直接读懂该怎么调。1129 已官方提供这份文档，不用自己手写。 ## What：文档地址 | 格式 | 地址 | |----|----| | YAML（在线/下载） | `https://www.showapi.com/openapi/market/1129.yaml` | | JSON | `https://www.showapi.com/openapi/market/1129.json` | 文档覆盖本接口全部接入点（生成 1129-1、上传图片识别 1129-2、图片链接识别 1129-3、Base64 识别 1129-4）。 ## How：导入到 Postman / Swagger **方式 A：Postman** 1. 打开 Postman → Import。 2. 填入 YAML 地址 `https://www.showapi.com/openapi/market/1129.yaml`（或先下载再选文件）。 3. 导入后自动生成各接入点的请求集合，把 `appKey` 参数替换为你的真实 AppKey 即可调试。 **方式 B：Swagger UI / Swagger Editor** 1. 打开 Swagger Editor（或自建 Swagger UI）。 2. 粘贴/导入 `1129.yaml` 内容。 3. 在文档内直接对每个接入点 "Try it out"，填入 `content`/`imgUrl` 等参数发起调用。 下载 YAML（cURL）： ```bash curl -O https://www.showapi.com/openapi/market/1129.yaml ``` Node.js（读取后交给 Swagger/代码生成器）： ```javascript const yaml = await (await fetch("https://www.showapi.com/openapi/market/1129.yaml")).text(); console.log("OpenAPI 长度:", yaml.length, "（可写入 swagger.yaml 供 UI 加载）"); ``` ## 返回示例与解析 OpenAPI 文档本身描述请求/响应结构。实际业务返回仍封装在 `showapi_res_body` 内：生成得 `imgUrl`、识别得 `retText`，成功以 `ret_code == "0"` 判定。字段细节见 [返回字段全解](https://www.showapi.com/guides/barcode-response-fields-1129)。 ## 进阶 / 边界 - **AI Agent 可直消费**：OpenAPI 是标准契约，很多 Agent/代码生成器能直接读取并生成调用代码，降低接入成本。 - **档位限制仍在**：导入文档只是"契约与调试"，真实调用仍受免费档位限制，详见 [档位说明](https://www.showapi.com/free-api)。 - **文档不含业务失败码表**：OpenAPI 描述结构与参数，具体 `ret_code` 仅定义 0/其他二态，排查见 [错误排查指南](https://www.showapi.com/guides/barcode-error-handling-1129)。 ## FAQ **Q：能导入 Apifox 吗？** 本文不提供 Apifox 相关用法。该 OpenAPI 文档可导入 Postman / Swagger UI / Swagger Editor 等标准工具消费。 **Q：文档会随接口更新吗？** 以 ShowAPI 官方发布的 `1129.yaml` / `1129.json` 为准，建议从官网地址获取最新版，不要长期缓存旧副本。 **Q：OpenAPI 里 appKey 怎么处理？** `appKey` 作为查询参数出现在各接入点 URL 中，导入后在工具里填入你的真实 AppKey 即可；注意不要在共享文档中硬编码真实 key。 **Q：用 OpenAPI 能自动生成 SDK 吗？** 可以，OpenAPI 是代码生成器的通用输入（如 openapi-generator），可据此生成多语言客户端；具体以你选用的生成器支持为准。 ## 相关能力 / 下一步阅读 - [通过 MCP 协议在 AI 客户端直接调用条码生成与识别](https://www.showapi.com/guides/barcode-mcp-integration-1129) - [条码生成与识别：5 分钟接入，从注册到生成第一条条码与识别第一张图](https://www.showapi.com/guides/barcode-quickstart-1129) - [条码生成与识别：返回字段全解（imgUrl / retText / ret_code / msg）](https://www.showapi.com/guides/barcode-response-fields-1129) - **本系列共 12 篇**：查看[条码生成与识别指南总目录](https://www.showapi.com/guides/barcode-guides-1129)