慈善搜索API - 非营利数据查询

接入教程

1. 访问API网站注册获取API密钥。
2. 使用搜索端点，输入慈善名称或地点参数。
3. 解析返回的JSON数据，获取机构详情。
4. 可选：集成到应用中以实现实时查询功能。

Python 搜索慈善机构示例

python

import requests

base_url = 'http://charityapi.orghunter.com/v1'
api_key = 'YOUR_API_KEY'

headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

# 示例搜索参数
search_params = {
    'name': '儿童基金会',
    'city': '北京',
    'category': '教育'
}

try:
    response = requests.get(
        f'{base_url}/charities/search',
        headers=headers,
        params=search_params
    )
    response.raise_for_status()
    charities = response.json()
    print(f'找到 {len(charities)} 个结果')
except requests.exceptions.RequestException as e:
    print(f'请求失败: {e}')

PHP 获取慈善详情示例

php

<?php

$base_url = 'http://charityapi.orghunter.com/v1';
$api_key = 'YOUR_API_KEY';

$charity_id = '示例机构ID';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $base_url . '/charities/' . $charity_id);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $api_key,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
if ($response === false) {
    echo '请求失败: ' . curl_error($ch);
} else {
    $charity_data = json_decode($response, true);
    echo '机构名称: ' . $charity_data['name'] . '\n';
}
curl_close($ch);
?>

JavaScript 按分类列出慈善机构

javascript

const baseUrl = 'http://charityapi.orghunter.com/v1';
const apiKey = 'YOUR_API_KEY';

async function fetchCharitiesByCategory(category) {
    const url = `${baseUrl}/charities`;
    
    try {
        const response = await fetch(url, {
            method: 'GET',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Content-Type': 'application/json'
            },
            params: {
                category: category,
                limit: 10
            }
        });
        
        if (!response.ok) {
            throw new Error(`HTTP错误: ${response.status}`);
        }
        
        const data = await response.json();
        console.log(`分类"${category}"的慈善机构:`, data);
        return data;
    } catch (error) {
        console.error('获取数据失败:', error);
    }
}

// 使用示例
fetchCharitiesByCategory('医疗救助');

常见问题

如何获取API密钥？

请访问官方网站 http://charityapi.orghunter.com/ 注册账户并申请API密钥。免费套餐通常提供有限的请求次数，如需更多配额请查看定价页面。

API的请求频率有限制吗？

是的，根据您的订阅计划有不同的速率限制。免费版本通常为每分钟60次请求。建议在代码中添加适当的延迟和错误处理以避免超限。

支持哪些搜索参数？

主要支持名称、城市、省份、分类和状态等参数。您可以根据需要组合使用这些参数进行精确搜索，具体参数请参考API文档。