科学计算器导入 Postman / Swagger UI：用 OpenAPI 文档管理接口
# 科学计算器导入 Postman / Swagger UI：用 OpenAPI 文档管理接口
> 接口 免费科学计算器（apiCode 1699）· 接入点 科学计算器（1699-1）/ 规则列表（1699-2）· 免费 · OpenAPI 3.0 · 适合 API 治理 / 团队协作 · 阅读约 4 分钟
## 核心要点
- 科学计算器官方提供标准 **OpenAPI 3.0** 文档（YAML / JSON），覆盖全部接入点。
- 可导入 **Postman / Swagger UI / Swagger Editor**，自动生成请求模板与 Mock。
- 文档也可直接被 AI Agent 消费，做接口自动化调用。
> 本文全程使用 Postman / Swagger UI / Swagger Editor 等通用工具。本系列文章不使用 Apifox。
## Why：为什么要用 OpenAPI 管理接口
当团队多人协作、或要把接口接入自动化测试 / 网关时，一份机器可读的 OpenAPI 文档比口头约定可靠得多。导入后，Postman 会自动生成带鉴权位置的请求模板，Swagger UI 能在线试调，Swagger Editor 能可视化编辑——省去手敲参数、记错字段的麻烦。
## What：文档与接口速览
| 项目 | 说明 |
|------|------|
| 接口 | 免费科学计算器（apiCode 1699） |
| OpenAPI YAML | `https://www.showapi.com/openapi/market/1699.yaml` |
| OpenAPI JSON | `https://www.showapi.com/openapi/market/1699.json` |
| 覆盖接入点 | 科学计算器（1699-1）、支持的规则列表（1699-2） |
| 计费 | 免费，[使用档次限制](https://www.showapi.com/free-api) |
> 上述 YAML 文档实测存在（生成于 2026-08-26，标题「科学计算器」），可直接下载。
## How：导入到 Postman / Swagger
### 方式一：Swagger UI / Swagger Editor（在线查看与试调）
1. 打开 Swagger UI 或 Swagger Editor。
2. 粘贴 / 导入 YAML 地址：`https://www.showapi.com/openapi/market/1699.yaml`。
3. 文档加载后，展开 `1699-1` 接口，先在 `appKey` 参数填你的 AppKey，再填写 `num` / `operation` / `rad_or_ang` 试调。
### 方式二：Postman（生成请求集合）
1. 打开 Postman → 点击 **Import**。
2. 选择 **Link** 方式，填入 `https://www.showapi.com/openapi/market/1699.yaml`（或下载 JSON 后本地导入）。
3. 导入后自动生成请求集合；在每个请求的 `appKey` 查询参数填入你的 AppKey 即可调用。
### 直接用 curl 验证（无需工具）
```bash
curl -X POST "https://route.showapi.com/1699-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "num=2,3,4&operation=add&rad_or_ang="
```
## 返回示例与解析
OpenAPI 文档里每个接口标注了 `num` / `operation` / `rad_or_ang` 参数与返回结构（`showapi_res_body` 含 `ret_code` / `result` / `remark`）。调用后真实返回：
```json
{
"showapi_res_body": { "ret_code": 0, "remark": "成功", "result": 9.0 }
}
```
## 进阶 / 边界
- **鉴权位置**：`appKey` 是 URL 查询参数，导入后会落在 Query 参数区，别忘了填。
- **Mock / 自动化**：Postman 可基于 OpenAPI 生成 Mock Server；AI Agent 也可直接读取该 YAML 理解接口契约。
- **文档与实测差异**：OpenAPI 描述的是接口契约，个别操作（如 `subtraction` / `percentage`）实测暂不可用，已在[已知问题](https://www.showapi.com/guides/calculator-known-issues-1699)标注。
- **不使用 Apifox**：本篇及全系列均不采用 Apifox，相关需求以 Postman / Swagger UI / Swagger Editor 替代。
## FAQ
**Q1：OpenAPI 文档是最新的吗？**
实测 YAML 生成于 2026-08-26，标题「科学计算器」，可直接使用；如有更新以官网为准。
**Q2：没有 Postman 能用别的吗？**
能。Swagger UI / Swagger Editor 在线即可，或任意支持 OpenAPI 3.0 的工具。
**Q3：导入后怎么填 AppKey？**
`appKey` 是 Query 参数，在请求 URL 或参数面板里填你的真实 AppKey（[获取入口](https://www.showapi.com/console#/myApp)）。
**Q4：AI Agent 怎么消费这份文档？**
直接读取 YAML/JSON 作为接口契约即可，无需额外转换。
## 相关能力 / 下一步阅读
- [科学计算器通过 MCP 调用](https://www.showapi.com/guides/calculator-mcp-integration-1699) —— AI 客户端内直接算
- [科学计算器：5 分钟接入](https://www.showapi.com/guides/calculator-quickstart-1699) —— 最小可运行示例
- [科学计算器已知问题与使用避坑](https://www.showapi.com/guides/calculator-known-issues-1699) —— 文档未覆盖的坑
- **本系列共 11 篇**：查看[科学计算器开发指南总目录](https://www.showapi.com/guides/calculator-guides-1699)
