一、接口简介
该API提供化学方程式自动配平功能，通过输入反应物和生成物，返回配平后的完整方程式及结构化数据。适用于化学教学、实验设计等场景。
二、请求方式
- URL:
https://cn.apihz.cn/api/other/hxfcs.php - 方法: GET或POST
- 必填参数:
| 参数名 | 说明 | 示例 |
| id | 用户ID（数字） | id=10000000 |
| key | 用户通讯秘钥 | key=15he5h15ty854j5s |
| reactants | 反应物（英文逗号分隔） | reactants=H2,O2 |
| products | 生成物（英文逗号分隔） | products=H2O |
⚠️ 注意：请替换为官网注册的专属ID和KEY，公共测试账号（88888888）频次受限。
三、返回参数说明
| 参数名 | 说明 |
| code | 状态码（200成功，400错误） |
| msg | 提示信息 |
| fcs | 配平后的方程式（简化系数） |
| fcsall | 配平后的方程式（显示所有系数） |
| reactants | 反应物结构化数据（含系数/化学式） |
| products | 生成物结构化数据（含系数/化学式） |
四、调用示例（Python）
python
运行
复制
import requests url = "https://cn.apihz.cn/api/other/hxfcs.php" params = { "id": "YOUR_ID", # 替换真实ID "key": "YOUR_KEY", # 替换真实KEY "reactants": "KMnO4,HCl", "products": "KCl,MnCl2,Cl2,H2O" } response = requests.get(url, params=params) result = response.json() if result["code"] == 200: print("配平结果:", result["fcs"]) # 提取反应物系数 for item in result["reactants"]: print(f"{item['coefficient']}{item['formula']}", end=" + ") else: print("错误:", result["msg"])
五、成功返回示例
json
复制
{ "code": 200, "fcs": "2KMnO4 + 16HCl → 2KCl + 2MnCl2 + 5Cl2 + 8H2O", "fcsall": "2KMnO4 + 16HCl → 2KCl + 2MnCl2 + 5Cl2 + 8H2O", "reactants": [ {"formula": "KMnO4", "coefficient": 2}, {"formula": "HCl", "coefficient": 16} ], "products": [ {"formula": "KCl", "coefficient": 2}, {"formula": "MnCl2", "coefficient": 2}, {"formula": "Cl2", "coefficient": 5}, {"formula": "H2O", "coefficient": 8} ] }
六、错误处理示例
json
复制
{ "code": 400, "msg": "通讯秘钥错误" }
七、注意事项
- 化学式规范：区分大小写（如
Fe不能写为fe），多原子团用括号（如Cu(NO3)2） - 频次限制：私有ID无每日上限，公共ID共享每分钟10次限制
- 数据版权：API数据来源于apihz.cn
通过此API，开发者可快速集成化学计算功能，适用于在线教育平台、实验报告生成系统等场景。实际使用时请遵守平台API调用规范。
