FaviconSnap

📚 API 文档

REST API 全球CDN 毫秒级响应

⚡

三层缓存架构

浏览器→边缘→KV存储，95%+缓存命中率

🌍

全球加速

200+边缘节点，就近响应用户请求

🔧

多种格式

支持图片、JSON两种返回格式

📍 API 端点

GET https://faviconsnap.com/api/favicon

📝 请求参数

url

string

✅

目标网站的URL

format

string

❌

返回格式: image(默认) | json

size

integer

❌

图标大小: 16, 32(默认), 64, 128

nocache

boolean

❌

跳过缓存，强制重新获取

📤 响应格式

🖼️ 图片格式 (默认)

直接返回 favicon 图片的二进制内容，可直接在 <img> 标签中使用

响应头:

Content-Type: image/x-icon | image/png | image/svg+xml
X-Favicon-Source: html | direct | google
X-Favicon-Cached: true | false
Cache-Control: public, max-age=7200

📋 JSON 格式 (format=json)

返回包含详细信息的JSON数据

{
  "success": true,
  "url": "https://github.com",
  "favicon": "https://github.com/favicon.ico",
  "size": "32x32",
  "source": "direct",
  "cached": true,
  "cacheSource": "kv",
  "cachedAt": "2025-08-03T10:30:00Z"
}

⚡ 性能指标

20-50ms

平均响应时间

95%+

缓存命中率

200+

全球节点

99.9%

可用性保证

🎯 在线演示