RescueGroups动物领养API

接入教程

1. 访问RescueGroups官网注册开发者账号并申请API密钥。
2. 查阅API文档了解可用端点（如动物列表、机构信息等）。
3. 使用API密钥通过HTTP请求调用数据（支持JSON格式）。
4. 处理返回的动物领养数据并集成到您的应用中。
5. 遵循API使用条款和速率限制进行开发。

获取可用动物列表

python

import requests

url = 'https://api.rescuegroups.org/v2/public/animals/search/available'
headers = {
    'Authorization': 'YOUR_API_KEY'
}
params = {
    'limit': 10,
    'species': 'dog'
}

response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f'Found {len(data.get("data", []))} animals')

查询机构信息

php

<?php
$url = 'https://api.rescuegroups.org/v2/public/organizations';
$apiKey = 'YOUR_API_KEY';

$options = [
    'http' => [
        'method' => 'GET',
        'header' => "Authorization: $apiKey\r\n"
    ]
];
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);

if ($response !== false) {
    $data = json_decode($response, true);
    echo 'Organizations fetched: ' . count($data['data'] ?? []);
} else {
    echo 'Request failed';
}
?>

按条件搜索宠物

javascript

const fetch = require('node-fetch');

async function searchPets() {
    const url = 'https://api.rescuegroups.org/v2/public/animals/search';
    const apiKey = 'YOUR_API_KEY';
    
    const response = await fetch(url, {
        method: 'GET',
        headers: {
            'Authorization': apiKey,
            'Content-Type': 'application/json'
        }
    });
    
    const data = await response.json();
    console.log(`Search results: ${data.data?.length || 0} pets`);
}

searchPets();

常见问题

如何获取API密钥？

您需要在RescueGroups官网注册账户，然后在开发者控制台中创建应用以获取API密钥。密钥用于认证所有API请求。

API请求频率有限制吗？

是的，RescueGroups API设有速率限制，具体限制根据您的账户类型而定。免费层通常为每分钟60次请求。超出限制会收到429状态码。

API支持哪些数据格式？

API主要支持JSON格式的请求和响应。某些端点可能也支持XML，但建议使用JSON以获得最佳兼容性和性能。