导入 OpenAPI 文档：用 Apifox/Postman 管理外汇数据接口

# 导入 OpenAPI 文档：用 Apifox/Postman 管理外汇数据接口 > 接口级 · 免费 · OpenAPI 3.0 · 适用：注重 API 治理的团队 · 阅读时间：6 分钟 ## TL;DR - 外汇数据查询提供**接口级 OpenAPI 3.0 文档**，覆盖全部 4 个接入点。 - 文档地址：`https://www.showapi.com/openapi/market/1683.yaml`（可在线看、下载 YAML、看 JSON）。 - 导入 Apifox / Postman / Swagger UI 后，可自动生成请求模板与 Mock 数据。 ## Why：用 OpenAPI 做接口治理 团队多人协作时，靠口口相传「参数是 begin/end」很容易出错。把官方 OpenAPI 文档导入 API 工具，所有人拿到的是同一份权威定义，还能一键发请求、做 Mock、写自动化测试。 ## What：OpenAPI 资源 | 项 | 说明 | |----|------| | 文档格式 | OpenAPI 3.0 | | 覆盖范围 | 全部接入点（1683-1/2/3/4） | | 在线查看 | YAML 链接可浏览器直接打开 | | 下载 | 支持下载 YAML / 查看 JSON | | 可导入 | Apifox / Postman / Swagger UI / 供 AI Agent 消费 | ## How：导入到 Apifox（示意） 1. 打开 Apifox → 项目 →「导入」→ 选择 OpenAPI。 2. 填入文档地址 `https://www.showapi.com/openapi/market/1683.yaml`，或先下载 YAML 再上传。 3. 导入后，4 个接入点会以独立接口列出，每个自带参数定义。 4. 在「环境」里配置 `appKey` 变量，即可直接调试。 **Postman / Swagger UI**：同样支持通过 URL 或文件导入 OpenAPI 3.0 文档，步骤类似。 ## 进阶 / 边界 - **文档与实时行为以接口为准**：OpenAPI 是结构描述，具体字段取值/边界（如 30 天上限、limit≤60）以接口实际返回与文档说明为准。 - **AppKey 不入文档**：OpenAPI 不含你的 AppKey，调试时通过环境变量注入。 - **数据延迟属性不变**：经文档调试拿到的仍是延迟数据。 ## FAQ **Q1：OpenAPI 和 MCP 用哪个？** A：写代码/做治理用 OpenAPI；想让 AI 直接调，用 MCP。两者覆盖的接入点一致。 **Q2：文档会包含所有接入点吗？** A：会，官方说明该 OpenAPI 覆盖本接口全部接入点。 **Q3：能生成 Mock 数据吗？** A：可，Apifox/Postman 等导入后可基于 schema 生成 Mock。 **Q4：YAML 和 JSON 哪个好？** A：功能等价，YAML 更易读、JSON 更易程序解析，按工具习惯选。 ## 下一步阅读 - [通过 MCP 协议在 AI 客户端中直接查询外汇数据](https://www.showapi.com/guides/forex-mcp-1683) - [外汇数据查询：5 分钟接入，从注册到第一条热门外汇列表](https://www.showapi.com/guides/forex-quickstart-1683) - [外汇数据查询：返回字段与数据结构全解](https://www.showapi.com/guides/forex-response-fields-1683) - **本系列共 13 篇**：查看[外汇数据查询指南总目录](https://www.showapi.com/guides/forex-guides-1683)