接入教程
1. 访问官网注册账号
2. 获取API密钥
3. 调用端点获取图片
4. 集成到你的应用中
5. 自定义请求参数
6. 开始使用并分享内容
Python 请求示例
python
import requests
base_url = 'https://catboys.com/api'
api_key = 'YOUR_API_KEY'
# 获取随机猫男孩图片
response = requests.get(
f'{base_url}/img/random',
headers={'Authorization': f'Bearer {api_key}'}
)
if response.status_code == 200:
data = response.json()
print(f'图片URL: {data["url"]}')
print(f'作者: {data["artist"]}')
else:
print(f'请求失败: {response.status_code}')
PHP 请求示例
php
<?php
$base_url = 'https://catboys.com/api';
$api_key = 'YOUR_API_KEY';
// 获取猫男孩GIF列表
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $base_url . '/gif');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $api_key
]);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($http_code == 200) {
$data = json_decode($response, true);
echo 'GIF数量: ' . count($data['gifs']) . "\n";
foreach ($data['gifs'] as $gif) {
echo '标题: ' . $gif['title'] . "\n";
}
} else {
echo '请求失败: ' . $http_code;
}
?>
JavaScript Fetch 示例
javascript
const baseUrl = 'https://catboys.com/api';
const apiKey = 'YOUR_API_KEY';
// 通过ID获取特定猫男孩内容
async function fetchCatboyContent(contentId) {
try {
const response = await fetch(`${baseUrl}/content/${contentId}`, {
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
}
});
if (!response.ok) {
throw new Error(`HTTP错误: ${response.status}`);
}
const data = await response.json();
console.log('内容详情:', data);
return data;
} catch (error) {
console.error('获取内容失败:', error);
return null;
}
}
// 使用示例
fetchCatboyContent('123');
常见问题
如何获取API密钥?
请访问Catboy官方网站(https://catboys.com/api)注册账户,然后在用户仪表板中生成您的专属API密钥。免费套餐提供有限的请求次数,付费套餐可获得更多功能。
API请求有什么限制?
免费套餐通常限制每分钟10次请求,每天100次请求。付费用户根据套餐等级享有更高的请求限额。所有请求都需要在HTTP头部包含有效的API密钥进行身份验证。
API返回什么格式的数据?
API默认返回JSON格式的数据,包含图片URL、元数据、作者信息等。您可以通过设置Accept请求头来指定其他格式,但JSON是推荐且最常用的格式。
Aitishiku.com