二维码生成和识别：导入 Postman / Swagger 用 OpenAPI 管理接口

# 二维码生成和识别：导入 Postman / Swagger 用 OpenAPI 管理接口 > 接口/接入点：二维码生成和识别（apiCode=887，OpenAPI 3.0 覆盖全部接入点）· 是否免费：是 · 返回格式：JSON · 适用人群：注重 API 治理的团队 · 阅读时间：约 4 分钟 ## 核心要点 - ShowAPI 提供标准 OpenAPI 3.0 文档（YAML/JSON），覆盖 887 全部 4 个接入点。 - 可导入 **Postman / Swagger UI**（或供 AI Agent 直接消费）做接口管理、Mock 与调试。 - 文档地址：`https://www.showapi.com/openapi/market/887.yaml`（JSON 版同名 `.json`）。 ## Why：用 OpenAPI 做接口治理 团队接入多个接口时，一份机器可读的 OpenAPI 文档能自动生成请求模板、Mock 数据与可视化调试页，省去手抄参数。本接口的 OpenAPI 文档可直接导入主流工具。 ## What：OpenAPI 资源 | 资源 | 地址 | |------|------| | OpenAPI 3.0 YAML | https://www.showapi.com/openapi/market/887.yaml | | OpenAPI 3.0 JSON | https://www.showapi.com/openapi/market/887.json | | 覆盖范围 | 887 全部接入点（生成 + 三种识别） | ## How：导入 Postman 1. 下载 YAML：`https://www.showapi.com/openapi/market/887.yaml` 2. 打开 Postman → Import → 选择该 YAML 文件。 3. 导入后自动生成各接入点请求模板，填入 AppKey 即可调试。 ### 导入 Swagger UI / Swagger Editor - Swagger UI：部署或打开支持"Load URL"的 Swagger UI，填入上述 YAML 地址。 - Swagger Editor：打开编辑器，File → Import URL，粘贴 YAML 地址，实时渲染接口文档与可试调面板。 ### 直接看文档（不依赖工具） ```bash curl -s "https://www.showapi.com/openapi/market/887.yaml" | head -n 20 ``` ## 进阶 / 边界 - **Mock 与调试**：导入后可用工具自带的 Mock Server 做前端联调，无需真实调用。 - **AI Agent 消费**：OpenAPI 文档可被支持的工具直接读取，配合[MCP 集成](https://www.showapi.com/guides/qrcode-mcp-integration-887)使用。 - **参数以文档为准**：OpenAPI 与接口页参数一致；实战注意 `flag` 拼写、887-4 无 flag/msg 等（见[返回字段全解](https://www.showapi.com/guides/qrcode-response-fields-887)）。 ## FAQ **Q1：OpenAPI 覆盖全部接入点吗？** A：是，覆盖 887-1 生成与 887-2/3/4 三种识别。 **Q2：导入后还要自己写请求吗？** A：不需，模板自动生成，填 AppKey 与参数即可。 **Q3：能用它生成 Mock 数据吗？** A：能，Postman / Swagger UI 均支持基于文档的 Mock。 **Q4：文档会更新吗？** A：以官方 OpenAPI 地址为准；接口有调整时重新拉取即可。 ## 相关能力 / 下一步阅读 - [二维码生成和识别：通过 MCP 协议在 AI 客户端直接调用](https://www.showapi.com/guides/qrcode-mcp-integration-887) - [二维码生成和识别：返回字段全解（ret_code / flag / imgUrl / retText）](https://www.showapi.com/guides/qrcode-response-fields-887) - [二维码生成和识别：5 分钟接入，从注册到生成第一个二维码](https://www.showapi.com/guides/qrcode-quickstart-887) - **本系列共 12 篇**：查看[二维码生成和识别指南总目录](https://www.showapi.com/guides/qrcode-guides-887)