科学计算器操作名速查：32 个 operation 完整清单与中文释义
# 科学计算器操作名速查：32 个 operation 完整清单与中文释义
> 接口 免费科学计算器（apiCode 1699）· 接入点 支持的规则列表（1699-2）/ 科学计算器（1699-1）· 免费 · POST/GET · 返回 JSON · 适合 所有开发者 / 学生 · 阅读约 6 分钟
## 核心要点
- 科学计算器共 **32 个操作名**，通过 `operation` 参数指定，全部经接口 `1699-2` 实测返回核对。
- 按参数个数分三类：**单参数**（如 `sin`、`factorial`）、**双参数**（如 `add`、`sqrt`、`square`）、**多参数**（如 `add 2,3,4`）。
- ⚠️ `subtraction`（减）与 `percentage`（百分比）**实测暂不可用**（返回「方法调用出错」），本表已标注。
## Why：为什么需要一张操作名清单
文档把 32 个操作名挤在参数说明里，不好检索；而且其中有 2 个（减法、百分比）实际调不通。本页把全部操作名、中文释义、参数个数、示例一并列清，作为全系列唯一可搜索的「操作名词典」，其他文章都链接回这里。
## What：接口速览
| 项目 | 说明 |
|------|------|
| 计算接入点 | `https://route.showapi.com/1699-1?appKey={your_appKey}` |
| 规则列表接入点 | `https://route.showapi.com/1699-2?appKey={your_appKey}`（返回 32 个操作名+中文） |
| `operation` 取值 | 下表 32 个英文操作名之一 |
| 计费 | 免费，[使用档次限制](https://www.showapi.com/free-api) |
## How：完整操作名清单（实测 1699-2 返回）
> 参数个数说明：`单`=1 个 `num`；`双`=2 个 `num`（逗号分隔）；`多`=2 个及以上。示例均为实测结果。
| 操作名 | 中文 | 参数 | 示例（num → 结果） | 状态 |
|--------|------|------|-------------------|------|
| `add` | 加 | 多 | `2,3,4` → `9.0` | ✅ |
| `subtraction` | 减 | 双 | `10,2` → 方法调用出错 | ⚠️ 暂不可用 |
| `product` | 乘 | 多 | `2,3,4` → `24.0` | ✅ |
| `divide` | 除 | 双 | `10,2` → `5.0` | ✅ |
| `mod` | 求余 | 双 | `10,3` → `1.0` | ✅ |
| `square` | 幂次方 | 双 | `2,3` → `8.0`（=2³） | ✅ |
| `sqrt` | 开根 | 双 | `2,9` → `1.08006`（=2^(1/9)） | ✅（须 2 参） |
| `rec` | 倒数 | 单 | `4` → `0.25` | ✅ |
| `absolute` | 绝对值 | 单 | `-5` → `5.0` | ✅ |
| `factorial` | 阶乘 | 单 | `5` → `120.0` | ✅ |
| `percentage` | 百分比 | — | `50,10` → 方法调用出错 | ⚠️ 暂不可用 |
| `log` | 对数（常用） | 单 | `100` → `2.0`（log₁₀） | ✅ |
| `ln` | 自然对数 | 单 | `10` → `2.3026` | ✅ |
| `exp` | 指数函数 | 单 | `1` → `2.71828` | ✅ |
| `sin` | 正弦 | 单 | `30,ang` → `0.5` | ✅ |
| `cos` | 余弦 | 单 | `60,ang` → `0.5` | ✅ |
| `tan` | 正切 | 单 | `45,ang` → `1.0` | ✅ |
| `cot` | 余切 | 单 | — | ✅ |
| `sec` | 正割 | 单 | — | ✅ |
| `csc` | 余割 | 单 | — | ✅ |
| `arcsin` | 反正弦 | 单 | `0` → `0.0`（弧度） | ✅ |
| `arccos` | 反余弦 | 单 | `0` → `1.5708`（弧度） | ✅ |
| `arctan` | 反正切 | 单 | — | ✅ |
| `arccot` | 反余切 | 单 | — | ✅ |
| `arcsec` | 反正割 | 单 | — | ✅ |
| `arccsc` | 反余割 | 单 | — | ✅ |
| `sinh` | 双曲正弦 | 单 | `0` → `0.0` | ✅ |
| `cosh` | 双曲余弦 | 单 | — | ✅ |
| `tanh` | 双曲正切 | 单 | — | ✅ |
| `coth` | 双曲余切 | 单 | — | ✅ |
| `sech` | 双曲正割 | 单 | — | ✅ |
| `csch` | 双曲余割 | 单 | — | ✅ |
### 调用示例（Python）
```python
import requests
APP_KEY = "YOUR_APPKEY"
def calc(num, op, rad=""):
r = requests.post(
"https://route.showapi.com/1699-1",
params={"appKey": APP_KEY},
data={"num": num, "operation": op, "rad_or_ang": rad},
timeout=10
)
b = r.json()["showapi_res_body"]
return b["result"] if str(b.get("ret_code")) == "0" else f"失败: {b.get('remark')}"
print(calc("2,3,4", "add")) # 9.0
print(calc("2,3", "square")) # 8.0 (2^3)
print(calc("100", "log")) # 2.0 常用对数
print(calc("30", "sin", "ang")) # 0.5 角度制
```
## 返回示例与解析
`1699-2`（规则列表）真实返回节选（实测）：
```json
{
"showapi_res_body": {
"operation": {
"divide": "除",
"tan": "正切",
"arccos": "反余弦",
"log": "对数",
"sin": "正弦",
"factorial": "阶乘",
"square": "幂次方",
"sqrt": "开根"
},
"ret_code": 0
}
}
```
## 进阶 / 边界
- **`sqrt` 必须传 2 个参数**：`sqrt(a,b)` 表示「b 次根号下 a」=`a^(1/b)`。单参数 `sqrt(9)` 会退化成返回 `9`（原值），不是 3。详见[幂与根用法](https://www.showapi.com/guides/calculator-power-root-1699)。
- **`log` 是常用对数（以 10 为底）**，不是自然对数；自然对数用 `ln`。详见[对数体系](https://www.showapi.com/guides/calculator-log-ln-1699)。
- **三角函数角度制要显式传 `rad_or_ang=ang`**，反三角一律返回弧度。详见[角度制实战](https://www.showapi.com/guides/calculator-trig-angles-1699)。
## FAQ
**Q1：怎么拿到这份清单？**
直接调接入点 `1699-2`，返回 `operation` 对象就是全部操作名+中文。本表已实测核对。
**Q2：`subtraction` 和 `percentage` 为什么标红？**
两者都列在官方操作名里，但实测（多种参数格式）均返回「方法调用出错」(ret -1)，暂时不可用。详见[已知问题](https://www.showapi.com/guides/calculator-known-issues-1699)。
**Q3：做减法有没有替代方案？**
可改用 `add` 传负数（如 `num=10,-2&operation=add`），或用 `product` 乘 `-1` 后相加。具体以你实测为准。
**Q4：`add` / `product` 最多能几个数？**
`num` 用逗号分隔，支持多个；实测 `2,3,4` 正常。具体上限以官方档位说明为准。
**Q5：操作名大小写敏感吗？**
文档与实测均使用全小写英文，建议严格按本表拼写（如 `arccos` 而非 `Arccos`）。
**Q6：找不到我要的矩阵 / 统计运算？**
本接口覆盖基础科学计算（算术、对数、三角、双曲、阶乘、幂/根），不含矩阵运算或统计分析。
## 相关能力 / 下一步阅读
- [科学计算器幂与根用法](https://www.showapi.com/guides/calculator-power-root-1699) —— `square` / `sqrt` 多参数语义
- [科学计算器对数体系](https://www.showapi.com/guides/calculator-log-ln-1699) —— `log` 与 `ln` 区别
- [科学计算器已知问题与使用避坑](https://www.showapi.com/guides/calculator-known-issues-1699) —— 不可用操作与退化行为
- **本系列共 11 篇**：查看[科学计算器开发指南总目录](https://www.showapi.com/guides/calculator-guides-1699)
