获取网站Favicon图标
通过目标网站的域名获取其Favicon图标地址,返回JSON数据。
GETJSON已发布版本 1.0
快速接入
QUICK START- 01查看参数说明选择请求方式与取值
- 02查看实际响应
- 03复制代码开始接入按你的开发语言选择
示例请求
每个 IP 每分钟 120 次;图片接口可能另有较低额度。限流时请按 Retry-After 等待。
请求参数
| 参数 | 类型 / 必填 | 示例 / 默认 | 说明 / 取值 |
|---|---|---|---|
domain | String · 必填 | api.keguan.org.cn默认:无 | 目标网站的域名(支持带协议) |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
favicon | String | 成功时返回Favicon图标的完整URL |
返回示例
成功响应:
{
"favicon": "https://www.google.com/favicon.ico"
}
参数缺失错误:
{
"error": "Domain parameter is required."
}
域名格式错误:
{
"error": "Invalid domain format."
}
未找到Favicon:
{
"error": "Favicon not found."
}错误说明
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数无效 |
| 405 | 请求方法不支持 |
| 413 | 请求内容过大 |
| 429 | 请求过于频繁 |
| 502 | 上游服务不可用 |
| 503 | 接口维护中 |
400:检查参数;429:按 Retry-After 等待;503:维护中;502:上游暂不可用,可稍后重试或反馈。
响应结果
RESPONSE点击发送请求后查看响应。
接入代码
INTEGRATION代码根据当前请求方式和参数生成。先到在线调试填入参数,再复制到自己的程序。
站长补充的 PHP 示例
<?php
$url = 'https://api.keguan.org.cn/api/favicon/api.php?domain=api.keguan.org.cn';
$ch = curl_init($url);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 5, CURLOPT_TIMEOUT => 30, CURLOPT_SSL_VERIFYPEER => true, CURLOPT_SSL_VERIFYHOST => 2]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
if ($response === false) { throw new RuntimeException(curl_error($ch)); }
curl_close($ch);
if ($status >= 400) { throw new RuntimeException('HTTP ' . $status . ': ' . $response); }
header('Content-Type: ' . ($contentType ?: 'application/octet-stream'));
echo $response;