国际原油价格查询：导入 Postman / Swagger 用 OpenAPI 文档管理接口

# 国际原油价格查询：导入 Postman / Swagger 用 OpenAPI 文档管理接口 > 接口：国际原油价格查询（apiCode=1108）｜ 免费 ｜ OpenAPI 3.0 文档（接口级，覆盖全部接入点）｜ 适用人群：注重 API 治理的团队、后端工程师 ｜ 阅读时间：约 5 分钟 ## 核心要点 - 接口提供标准 OpenAPI 3.0 文档（YAML / JSON），可直接导入 Postman、Swagger UI、Swagger Editor。 - 导入后自动生成请求模板与字段说明，便于团队统一管理接口资产。 - 文档覆盖本接口全部接入点，可直接导入 Postman / Swagger UI / Swagger Editor 管理。 ## Why 当团队接的接口变多，靠收藏 curl 命令很容易乱。OpenAPI 文档是接口资产的"说明书"：导入 Postman 能一键生成可调用的请求、导入 Swagger UI 能直接在网页上试。国际原油价格查询提供了标准 OpenAPI 3.0 文档，本文教你怎么用它把接口管起来。 ## What | 项目 | 说明 | |------|------| | 文档格式 | OpenAPI 3.0 | | 覆盖范围 | 本接口全部接入点 | | 在线查看 | https://www.showapi.com/openapi/market/1108.yaml | | 下载 | YAML / JSON 同源地址 | ## How ### 步骤 1：获取 OpenAPI 文档 - YAML：https://www.showapi.com/openapi/market/1108.yaml - JSON：https://www.showapi.com/openapi/market/1108.json ### 步骤 2：导入 Postman 1. 打开 Postman，选择「Import」。 2. 粘贴上面的 YAML 或 JSON 地址（或下载后选择文件）。 3. 导入完成后，集合里会出现国际原油价格查询的请求模板，填入 AppKey 即可调用。 ### 步骤 3：用 Swagger UI / Swagger Editor 查看与调试 - 打开 Swagger Editor（或自托管 Swagger UI），粘贴 YAML 内容。 - 界面会渲染出接口路径、参数、响应结构，并可在「Try it out」中直接试调。 > 说明：本文以 Postman / Swagger UI / Swagger Editor 为例演示 OpenAPI 导入。接口官方 OpenAPI 文档可被 AI Agent 直接消费，也可用于生成 Mock 数据。 ## 返回示例与解析 通过 OpenAPI 文档可看到 `code` 参数（`wti`/`blt`）与 `showapi_res_body` 完整字段定义（含 `nowPrice` 为数字、其余价格字段为字符串等）。字段细节见 [返回字段全解](https://www.showapi.com/guides/crude-oil-price-fields-1108)。 ## 进阶 / 边界 - **统一工具栈**：本指南使用 Postman / Swagger UI / Swagger Editor 管理接口。 - **覆盖全部接入点**：该 OpenAPI 文档覆盖本接口全部接入点，不只 1108-1。 - **Mock 数据**：可用 OpenAPI 生成 Mock 做前端联调，但真实油价仍需调用接口获取。 ## FAQ **Q：OpenAPI 文档覆盖哪些接入点？** 覆盖本接口（apiCode=1108）全部接入点。 **Q：导入后还要自己填 AppKey 吗？** 要。AppKey 是你的鉴权凭证，在请求参数或配置中填入真实值。 **Q：除了 Postman 还能用别的吗？** 可以，任何支持 OpenAPI 3.0 的工具都行，如 Swagger UI、Swagger Editor。 **Q：能用这份文档给 AI Agent 用吗？** 可以，文档为标准 OpenAPI 3.0，可被 AI Agent 直接消费。 ## 相关能力 / 下一步阅读 - [国际原油价格查询：通过 MCP 在 AI 客户端里直接查油价](https://www.showapi.com/guides/crude-oil-price-mcp-1108) - [国际原油价格查询返回字段全解：nowPrice / diff_rate / stockNum 一文读懂](https://www.showapi.com/guides/crude-oil-price-fields-1108) - [国际原油价格查询：5 分钟从注册到拿到第一条 WTI 报价](https://www.showapi.com/guides/crude-oil-price-quickstart-1108) - **本系列共 12 篇**：查看[国际原油价格查询官方指南总目录](https://www.showapi.com/guides/crude-oil-price-guides-1108)