银行汇率查询：导入 OpenAPI 3.0 文档，在 Apifox / Postman 中管理四个接入点

# 银行汇率查询：导入 OpenAPI 3.0 文档，在 Apifox / Postman 中管理四个接入点 > 接口：银行汇率查询（apiCode=105）· 集成能力：OpenAPI 3.0（覆盖全部 4 接入点）· 适用人群：注重 API 治理的团队 · 阅读时间：约 5 分钟 ## TL;DR - 官方提供标准 OpenAPI 3.0 文档（YAML / JSON），覆盖全部 4 个接入点。 - 导入 Apifox / Postman / Swagger UI 即可自动生成请求模板与 Mock。 - 适合做接口治理、团队协作与自动化测试。 ## Why 团队接手一个接口，最怕"文档散、参数靠猜"。把官方 OpenAPI 文档导入到你们已经在用的 API 工具里，能一次性拿到四个接入点的完整定义：路径、参数、响应结构，还能直接发请求、做 Mock、写测试用例。本篇讲怎么导入与利用。 ## What | 项目 | 说明 | |------|------| | 文档格式 | OpenAPI 3.0（YAML / JSON） | | 覆盖范围 | 全部 4 个接入点（105-30/31/34/35） | | 文档地址 | `https://www.showapi.com/openapi/market/105.yaml`（线上查看/下载）、`.json` 同名路径 | | 适用工具 | Apifox、Postman、Swagger UI 等 | ## How ### 步骤：下载并导入 1. 获取文档： - 在线查看：`https://www.showapi.com/openapi/market/105.yaml` - 下载 YAML 或直接取 JSON：`https://www.showapi.com/openapi/market/105.json` 2. 在 Apifox / Postman 中选择「导入」，粘贴 YAML 内容或上传文件。 3. 导入后会出现四个接入点对应的请求定义，含参数与响应 schema。 4. 在请求地址里把 `appKey` 占位替换为你的真实 AppKey，即可发请求。 **示例：用 OpenAPI 生成的请求发一个实时查询** ```bash curl -X POST "https://route.showapi.com/105-30?appKey=YOUR_APPKEY" \ -H "content-type: application/x-www-form-urlencoded" \ -d "code=USD" ``` ### 团队用法建议 - **Mock 联调**：前端用 OpenAPI 生成的 Mock 先开发，不阻塞后端。 - **自动化测试**：把四个接入点纳入 CI 冒烟测试，回归参数与返回结构变化。 - **版本留档**：把 YAML 存进仓库，接口变更可 diff 比对。 ## 返回示例与解析 导入后各接入点响应结构与文档一致。字段含义、状态码判断见[字段全解](https://www.showapi.com/guides/exchange-rate-fields-105)；历史接入点字段命名不同，见[历史汇率指南](https://www.showapi.com/guides/exchange-rate-history-guide-105)。 ## 进阶 / 边界 - **覆盖全部接入点**：一份文档同时描述四个接入点，无需逐个找文档。 - **AppKey 占位**：OpenAPI 中 `appKey` 多为路径/query 占位，导入后请替换为你的真实值（建议用工具的环境变量管理，避免硬编码）。 - **数据为延迟数据**：工具里看到的牌价同样仅供参考。 ## FAQ **Q：OpenAPI 和 MCP 选哪个？** 用途不同：OpenAPI 适合 API 治理、团队协作、自动化测试；MCP 适合在 AI 客户端里对话式调用。两者底层都是同一套接口，可同时用。 **Q：文档会随接口更新吗？** 以官方 `openapi/market/105.yaml` 线上版本为准，建议团队定期重新拉取并 diff。 **Q：能导入 Swagger UI 吗？** 能，只要是兼容 OpenAPI 3.0 的工具都可导入。 ## 相关能力 / 下一步阅读 - [银行汇率查询：通过 MCP 协议在 AI 客户端（Cherry Studio / ChatBox）直接查汇率](https://www.showapi.com/guides/exchange-rate-mcp-105) - [银行汇率查询：返回字段与状态码全解](https://www.showapi.com/guides/exchange-rate-fields-105) - **本系列共 13 篇**：查看[银行汇率查询指南总目录](https://www.showapi.com/guides/exchange-rate-guides-105)