接入教程
1. 注册获取API密钥
2. 查阅官方文档了解端点格式
3. 构造查询请求(如物种搜索)
4. 处理返回的JSON数据
5. 可选:设置筛选条件(分类/区域)
6. 集成到应用程序中
查询物种保护状态
python
import requests
url = 'https://apiv3.iucnredlist.org/api/v3'
params = {
'token': 'YOUR_API_KEY',
'species': 'Panthera leo'
}
response = requests.get(f'{url}/species', params=params)
if response.status_code == 200:
data = response.json()
print(data)
else:
print(f'Error: {response.status_code}')
按分类群获取物种列表
php
<?php
$baseUrl = 'https://apiv3.iucnredlist.org/api/v3';
$apiKey = 'YOUR_API_KEY';
$group = 'mammals';
$url = $baseUrl . '/species/group/' . $group . '?token=' . $apiKey;
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
if ($response !== false) {
$data = json_decode($response, true);
print_r($data);
} else {
echo '请求失败';
}
?>
按区域筛选濒危物种
javascript
const fetch = require('node-fetch'); // 或在浏览器中使用原生fetch
async function getSpeciesByRegion(region) {
const baseUrl = 'https://apiv3.iucnredlist.org/api/v3';
const apiKey = 'YOUR_API_KEY';
const url = `${baseUrl}/species/region/${region}/page/0?token=${apiKey}`;
try {
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
console.log(data);
return data;
} catch (error) {
console.error('请求失败:', error);
}
}
getSpeciesByRegion('global');
常见问题
如何获取API密钥?
请访问IUCN红色名录官方网站,在API文档部分注册账户并申请API密钥。密钥通常免费提供用于非商业和研究用途。
API请求频率有限制吗?
是的,IUCN API通常设有请求频率限制以保障服务稳定性。具体限制请查阅最新API文档,建议合理控制请求间隔并缓存常用数据。
可以查询哪些类型的物种数据?
该API提供物种保护状态(如濒危等级)、分类信息、地理分布范围、种群趋势、威胁因素以及相关文献引用等综合数据。
Aitishiku.com