接口简介
提供权威化学元素的100+项参数查询服务,涵盖原子结构、物理性质、分布数据等科研级参数。支持中文名称、元素符号(区分大小写)或原子序数查询,适用于教育软件、化学工具和科研系统开发。数据版权归属接口盒子。
一、核心参数说明
1. 请求参数(必填)
| 参数名 | 类型 | 是否必填 | 说明 |
id |
整数 | 是 | 用户ID(注册后获取) |
key |
字符串 | 是 | 用户通讯秘钥 |
name |
字符串 | 是 | 元素标识(例:"氢"/"H"/1) |
2. 返回参数
基础信息
| 参数 | 说明 |
code |
状态码(200成功/400错误) |
msg |
操作结果提示 |
id |
原子序数 |
zwmc |
元素中文名称 |
ysfh |
元素符号(区分大小写) |
ywmc |
英文名称 |
原子结构
| 参数 | 说明 |
yzzl |
原子质量 |
yzbj |
原子半径/Å |
dzgx |
电子构型 |
gjbj |
共价半径 |
yztj |
原子体积 |
lzbj |
离子半径 |
物理性质
| 参数 | 说明 |
fd |
沸点(℃) |
rd |
熔点(℃) |
md |
密度(g/cc,300K) |
br |
比热/J/gK |
rhr |
熔化热/KJ/mol |
zfr |
蒸发热/KJ/mol |
drxs |
导热系数/W/cmK |
ddl |
导电率/10⁶/cm |
分布数据
| 参数 | 说明 |
ty |
太阳丰度(相对H=1×10¹²) |
diq |
地壳丰度/p.p.m. |
hsz |
海水丰度/p.p.m. |
daq |
大气丰度/p.p.m.(体积) |
zlsj |
滞留时间/年 |
人体分布
| 参数 | 说明 |
xie |
血液含量/mg dm⁻³ |
gu |
骨骼含量/p.p.m. |
gan |
肝脏含量/p.p.m. |
jr |
肌肉含量/p.p.m. |
rsrl |
日摄入量/mg |
rtzl |
人体总量/mg(70kg标准) |
其他参数
| 参数 | 说明 |
yht |
氧化态 |
fx |
发现历史 |
ly |
元素来源 |
yt |
主要用途 |
zt |
物质状态 |
dzmx |
电子模型图URL |
二、调用示例
1. PHP调用(GET/POST)
php
复制
<?php // GET请求示例 $get_url = "https://cn.apihz.cn/api/other/yuansu.php?" . http_build_query([ 'id' => '10000000', // 替换实际ID 'key' => '15he5h15ty854j5sr152hs2', // 替换实际KEY 'name' => 'Fe' // 查询铁元素 ]); $get_data = json_decode(file_get_contents($get_url), true); // POST请求示例 $post_url = "https://cn.apihz.cn/api/other/yuansu.php"; $post_data = [ 'id' => '10000000', 'key' => '15he5h15ty854j5sr152hs2', 'name' => '26' // 原子序数查询 ]; $ch = curl_init($post_url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); $post_response = curl_exec($ch); curl_close($ch); $post_data = json_decode($post_response, true); // 结果解析 if ($get_data['code'] == 200) { echo "铁元素数据:\n"; echo "原子质量:" . $get_data['yzzl'] . "\n"; echo "电子模型图:" . $get_data['dzmx']; } ?>
2. Python调用(GET/POST)
python
运行
复制
import requests # GET请求示例 get_params = { "id": "10000000", # 替换实际ID "key": "15he5h15ty854j5sr152hs2", # 替换实际KEY "name": "Oxygen" # 英文名查询(需确保接口支持) } get_response = requests.get( "https://cn.apihz.cn/api/other/yuansu.php", params=get_params ) get_data = get_response.json() # POST请求示例 post_data = { "id": "10000000", "key": "15he5h15ty854j5sr152hs2", "name": "氧" # 中文名查询 } post_response = requests.post( "https://cn.apihz.cn/api/other/yuansu.php", data=post_data ) post_data = post_response.json() # 结果解析 if get_data['code'] == 200: print(f"氧元素电子构型: {get_data['dzgx']}") print(f"人体血液含量: {get_data['xie']} mg/dm³")
三、返回数据示例
成功响应(铁元素)
json
复制
{ "id": "26", "zwmc": "铁", "ysfh": "Fe", "ywmc": "Iron", "yzzl": "55.845", "yzbj": "1.72", "dzgx": "1s(2)|2s(2)p(6)|3s(2)p(6)d(6)|4s(2)", "gjbj": "1.17", "yztj": "7.1", "lzbj": "0.645", "yht": "2,3", "fx": "古代就已知。", "ly": "从铁矿获得。", "yt": "作为钢和合金被广泛使用,是血色素的主要成分", "zt": "银白色过渡金属。", "fd": "2750", "br": "0.44", "rhr": "13.8", "drxs": "0.802", "sd": "", "rd": "1535", "md": "7.874", "zfr": "349.6", "ddl": "0.0993", "zrd": "", "ty": "3.16 × 10(7)", "diq": "41 000", "tpybm": "0.1× 10(-4)", "dxysc": "4× 10(-4)", "zlsj": "98", "hsz": "", "dxybm": "1× 10(-4)", "daq": "", "tpysc": "1× 10(-4)", "qgz": "", "xie": "447", "gu": "3 - 380", "gan": "250 -1400", "jr": "180", "rsrl": "6 - 40", "rtzl": "4.2", "code": 200, "dzmx": "https://rescdn.apihz.cn/resimg/yuansu1/26.gif" }
错误响应
json
复制
{ "code": 400, "msg": "元素名称不存在" }
四、使用规范
- 密钥获取
访问接口盒子免费API官网注册获取专属id和key,公共密钥(id=88888888&key=88888888)限频60次/分钟。 - 请求限制
- 独享密钥:无日限额,60次/分钟
- 符号严格区分大小写(
"Co"钴正确,"CO"一氧化碳错误)
- 错误处理
| 状态码 | 原因 | 解决方案 |
| 400 | 秘钥错误 | 检查用户中心密钥 |
| 400 | 元素不存在 | 核对元素符号大小写 |
| 400 | 参数缺失 | 确认id/key/name全部提交 |
- 数据授权
禁止商用转售