Dog Facts API

接入教程

1. 访问Dog Facts API网站
2. 查看API文档了解端点
3. 发送GET请求到随机事实端点
4. 解析返回的JSON数据
5. 在应用中使用狗狗事实

Python请求示例

python

import requests

url = 'https://dukengn.github.io/Dog-facts-API/api/v1/resources/dogs?number=1'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    data = response.json()
    print(f'Dog Fact: {data[0]["fact"]}')
except requests.exceptions.RequestException as e:
    print(f'Request failed: {e}')

PHP请求示例

php

<?php

$url = 'https://dukengn.github.io/Dog-facts-API/api/v1/resources/dogs?number=1';
$options = [
    'http' => [
        'header' => "Authorization: Bearer YOUR_API_KEY\r\n",
        'method' => 'GET'
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);

if ($response !== false) {
    $data = json_decode($response, true);
    echo 'Dog Fact: ' . $data[0]['fact'];
} else {
    echo 'Request failed';
}

?>

JavaScript请求示例

javascript

const url = 'https://dukengn.github.io/Dog-facts-API/api/v1/resources/dogs?number=1';

fetch(url, {
    method: 'GET',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
    }
})
.then(response => {
    if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }
    return response.json();
})
.then(data => {
    console.log(`Dog Fact: ${data[0].fact}`);
})
.catch(error => {
    console.error('Request failed:', error);
});

常见问题

如何获取API密钥？

该API为免费服务，通常无需API密钥即可使用。如需认证，请参考官方文档的认证部分，使用YOUR_API_KEY作为占位符。

请求频率有限制吗？

免费API通常有请求频率限制，具体限制请查阅官方文档的速率限制部分，建议合理控制调用频率。

返回的数据格式是什么？

API通常返回JSON格式数据，包含事实文本等字段。具体字段结构请参考官方文档的响应示例部分。