# 科学计算器开发指南总目录
> 接口 免费科学计算器（apiCode 1699）· 昆明秀派科技（官方自营）· 分类 生活服务 · 免费 · POST/GET · 返回 JSON
## 接口一句话速览
**免费科学计算器** 是 ShowAPI 提供的科学计算接口：传入 `num`（计算值）与 `operation`（操作名），返回数学运算、三角函数、对数、双曲函数、阶乘、幂/根等计算结果。适合科研、工程、教育、数据分析与 AI 工具集成场景。注册即送免费额度，无需采购资源包。
> ⚠️ 接入前必读：[科学计算器已知问题与使用避坑](https://www.showapi.com/guides/calculator-known-issues-1699) —— `subtraction`/`percentage` 暂不可用、`sqrt` 单参数退化、官方文档示例为占位符。
## 全系列文章（11 篇，按阅读顺序）
### 入门层
1. [科学计算器：5 分钟接入，从注册到第一条计算结果](https://www.showapi.com/guides/calculator-quickstart-1699) —— 注册取 AppKey，三种语言跑通第一次调用。
2. [科学计算器返回字段全解：ret_code / result / remark 一文读懂](https://www.showapi.com/guides/calculator-response-fields-1699) —— 看懂成功/失败的返回结构与判断逻辑。
3. [科学计算器操作名速查：32 个 operation 完整清单与中文释义](https://www.showapi.com/guides/calculator-operations-reference-1699) —— 全部操作名、参数个数、可用状态（可搜索词典）。
### 场景实战层
4. [科学计算器三角函数角度制实战：rad 弧度 vs ang 角度怎么选？](https://www.showapi.com/guides/calculator-trig-angles-1699) —— 角度制必须显式传 `ang`，反三角返回弧度。
5. [科学计算器幂与根：square(a,b)=a^b、sqrt(a,b)=a^(1/b) 多参数用法](https://www.showapi.com/guides/calculator-power-root-1699) —— 幂/根必须传 2 个参数，单参数 `sqrt` 会退化。
6. [科学计算器对数体系：log 是常用对数(log10)、ln 是自然对数](https://www.showapi.com/guides/calculator-log-ln-1699) —— 分清 `log` 与 `ln` 的底数。
### 技术深挖层
7. [科学计算器多参数公式：用 add / product / 逗号分隔一次算多个数](https://www.showapi.com/guides/calculator-batch-formulas-1699) —— 一串数求和/连乘一次调用完成。
8. [科学计算器错误码排查：ret_code -1、方法调用出错、operation 不能为空](https://www.showapi.com/guides/calculator-error-codes-1699) —— `remark` 文案对照表，快速定位失败原因。
### 最佳实践层
9. [科学计算器已知问题与使用避坑：subtraction / percentage 暂不可用、sqrt 单参数退化](https://www.showapi.com/guides/calculator-known-issues-1699) —— 实测确认的坑点汇总（最高杠杆篇）。
### 生态集成层
10. [通过 MCP 在 Cherry Studio / ChatBox 中直接调用科学计算器](https://www.showapi.com/guides/calculator-mcp-integration-1699) —— 一段 JSON 让 AI 客户端直接算数。
11. [科学计算器导入 Postman / Swagger UI：用 OpenAPI 文档管理接口](https://www.showapi.com/guides/calculator-openapi-import-1699) —— 导入 OpenAPI 3.0，生成请求模板与 Mock。
## 相关资源表
| 资源 | 链接 |
|------|------|
| 接口详情页（1699） | https://www.showapi.com/apiGateway/view/1699 |
| 接入点：科学计算器（1699-1） | https://www.showapi.com/apiGateway/view/1699/1 |
| 接入点：支持的规则列表（1699-2） | https://www.showapi.com/apiGateway/view/1699/2 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/1699.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/1699.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费额度与档位说明 | https://www.showapi.com/free-api |
## 阅读建议
- **第一次接入**：按 1 → 2 → 3 顺序，先跑通再理解返回与操作名。
- **做数学/教学工具**：重点看 4（角度制）、5（幂与根）、6（对数），并提前看 9 避开坑。
- **接 AI / 做 API 治理**：直接看 10（MCP）与 11（OpenAPI 导入）。
- **排查问题**：先查 8（错误码），坑点优先查 9（已知问题）。
- **本系列共 11 篇**：查看[科学计算器开发指南总目录](https://www.showapi.com/guides/calculator-guides-1699)
