Safe Place API

接入教程

1. 阅读官方授权指南获取令牌
2. 在测试环境中验证接口调用
3. 配置API请求头与认证信息
4. 调用安全地点数据端点
5. 处理返回的JSON格式数据
6. 根据需求集成到应用程序中

Python调用示例

python

import requests

base_url = 'https://api.example.com'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

# 获取安全地点列表
response = requests.get(f'{base_url}/v1/safe-places', headers=headers)
if response.status_code == 200:
    data = response.json()
    print(f'Found {len(data["items"])} safe places')
else:
    print(f'Error: {response.status_code}')

# 查询特定地点详情
place_id = 'example_id'
detail_response = requests.get(f'{base_url}/v1/safe-places/{place_id}', headers=headers)

PHP调用示例

php

<?php

$baseUrl = 'https://api.example.com';
$apiKey = 'YOUR_API_KEY';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $baseUrl . '/v1/safe-places');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
if ($response === false) {
    echo 'Error: ' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    echo 'Found ' . count($data['items']) . ' safe places';
}
curl_close($ch);

// 获取特定地点详情
$placeId = 'example_id';
$detailUrl = $baseUrl . '/v1/safe-places/' . $placeId;
$detailCh = curl_init($detailUrl);
curl_setopt_array($detailCh, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json'
    ]
]);
$detailResponse = curl_exec($detailCh);
curl_close($detailCh);
?>

JavaScript调用示例

javascript

const baseUrl = 'https://api.example.com';
const apiKey = 'YOUR_API_KEY';

async function fetchSafePlaces() {
    try {
        const response = await fetch(`${baseUrl}/v1/safe-places`, {
            method: 'GET',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Content-Type': 'application/json'
            }
        });
        
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        
        const data = await response.json();
        console.log(`Found ${data.items.length} safe places`);
        return data;
    } catch (error) {
        console.error('Error fetching safe places:', error);
    }
}

// 获取特定地点详情
async function fetchSafePlaceDetail(placeId) {
    try {
        const response = await fetch(`${baseUrl}/v1/safe-places/${placeId}`, {
            method: 'GET',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Content-Type': 'application/json'
            }
        });
        return await response.json();
    } catch (error) {
        console.error(`Error fetching details for ${placeId}:`, error);
    }
}

// 使用示例
fetchSafePlaces();
// fetchSafePlaceDetail('example_id');

常见问题

如何获取API访问令牌？

使用前需阅读授权指南获取访问令牌。测试环境基于生产环境的子集，建议先通过授权流程获取有效的访问令牌。

测试环境与生产环境有什么区别？

测试环境仅包含生产环境数据的子集，主要用于开发和测试目的。正式使用时请切换到生产环境端点。

API调用频率有限制吗？

是的，API调用有速率限制以确保服务稳定性。具体限制请参考官方文档或联系技术支持获取详细信息。