导入 Postman / Swagger：用 OpenAPI 文档管理单位换算接口
OpenAPIPostmanSwaggerAPI治理 # 导入 Postman / Swagger：用 OpenAPI 文档管理单位换算接口
> 接口/接入点：免费单位换算 1690（OpenAPI 3.0 文档，覆盖全部接入点）｜是否免费：是｜集成方式：OpenAPI 导入｜适用人群：API 治理团队、注重文档的开发者｜阅读时间：约 5 分钟
## 核心要点
- 单位换算器提供标准 **OpenAPI 3.0** 文档（YAML/JSON），覆盖本接口全部接入点。
- 可导入 **Postman / Swagger UI / Swagger Editor**，自动生成请求模板与 Mock 数据，做接口治理。
- 本文主题仅围绕 Postman / Swagger 生态；不使用其他 API 工具。
## Why：用 OpenAPI 把接口管起来
团队接了多个接口，散落的 curl 难维护。把单位换算器的 OpenAPI 文档导入 Postman / Swagger，统一看参数、出 Mock、做联调，新人也能秒上手。
## What：OpenAPI 文档地址
| 格式 | 地址 |
|------|------|
| YAML（在线/下载） | https://www.showapi.com/openapi/market/1690.yaml |
| JSON | https://www.showapi.com/openapi/market/1690.json |
文档覆盖全部接入点：单位换算（1690-1）、支持的类型（1690-16）。
## How：导入 Postman / Swagger
**Postman**
1. 打开 Postman → Import。
2. 选择「Link」粘贴 `https://www.showapi.com/openapi/market/1690.yaml`，或下载 YAML 后本地导入。
3. 导入后自动生成请求集合，填 `appKey` 即可调试。
**Swagger UI / Swagger Editor**
1. 打开 Swagger Editor，粘贴 YAML 内容或引用地址。
2. 在「Try it out」中填 `num`/`from`/`to`/`type` 直接发起调用。
3. 可用其 Mock 能力做前端联调，不必等后端。
```bash
# 下载 OpenAPI 文档备用
curl -O https://www.showapi.com/openapi/market/1690.yaml
```
## 进阶 / 边界
- **仅 Postman / Swagger 生态**：本文不涉及其他 API 调试工具，主题聚焦 OpenAPI 导入与治理。
- **Mock 数据**：Swagger/Postman 的 Mock 用于联调，真实结果以调用接口返回为准。
- **密钥**：OpenAPI 文档不含你的 AppKey，调试时在请求参数填自己的密钥（[AppKey 管理](https://www.showapi.com/console#/myApp)）。
## FAQ
**Q1：OpenAPI 文档覆盖哪些接入点？**
A：覆盖本接口全部接入点（单位换算 1690-1、支持的类型 1690-16）。
**Q2：导入后怎么快速试调？**
A：Postman 填 `appKey` 直接 Send；Swagger UI 用 Try it out 填参发起调用。
**Q3：文档是 OpenAPI 3.0 吗？**
A：是，标准 OpenAPI 3.0，可导入 Postman / Swagger UI / Swagger Editor。
**Q4：能据文档生成 SDK 吗？**
A：OpenAPI 3.0 可被多数代码生成器消费，自行选用对应生成器即可；本文聚焦导入与调试。
## 相关能力 / 下一步阅读
- [通过 MCP 在 AI 客户端里直接做单位换算](https://www.showapi.com/guides/unit-convert-mcp-integration-1690)
- [单位换算器：5 分钟接入（从注册到第一次单位换算）](https://www.showapi.com/guides/unit-convert-quickstart-1690)
- [单位换算器返回字段全解：ret_code 与 result_list 一文读懂](https://www.showapi.com/guides/unit-convert-response-codes-1690)
- **本系列共 12 篇**：查看[单位换算器（免费单位换算）指南总目录](https://www.showapi.com/guides/unit-convert-guides-1690)
