Developer

API 接口文档

Favicon 获取服务的完整接口说明，支持多尺寸、多格式、批量查询

接口地址

GET https://dd.sw.tn/api/{域名}

基础用法

获取网站的 favicon 图标，直接在浏览器或代码中访问即可：

https://dd.sw.tn/api/baidu.com
https://dd.sw.tn/api/github.com

返回对应域名的 favicon 图标文件（默认 ICO 格式）。

参数说明

参数 类型 必填 说明
size int 否 输出尺寸：16、32、64、128、256
format string 否 输出格式：ico、png、svg、json
refresh int 否 设为 1 强制刷新缓存
key string 否 API Key（开启验证后必填）

尺寸选择

不同场景推荐不同尺寸：

# 16x16 - 浏览器标签页
https://dd.sw.tn/api/baidu.com?size=16

# 32x32 - 标准尺寸（默认）
https://dd.sw.tn/api/baidu.com?size=32

# 64x64 - 高清展示
https://dd.sw.tn/api/baidu.com?size=64&format=png

# 128x128 - 大图标展示
https://dd.sw.tn/api/baidu.com?size=128&format=png

格式选择

# ICO 格式（默认，兼容性最好）
https://dd.sw.tn/api/baidu.com

# PNG 格式（推荐高清场景）
https://dd.sw.tn/api/baidu.com?format=png

# SVG 格式（矢量，部分网站支持）
https://dd.sw.tn/api/github.com?format=svg

# JSON 格式（获取元数据，不返回图片）
https://dd.sw.tn/api/baidu.com?format=json

JSON 返回示例

{
  "ok": true,
  "domain": "baidu.com",
  "url": "https://dd.sw.tn/api/baidu.com",
  "formats": {
    "ico": "https://dd.sw.tn/api/baidu.com",
    "png": "https://dd.sw.tn/api/baidu.com?format=png",
    "svg": "https://dd.sw.tn/api/baidu.com?format=svg"
  },
  "sizes": {
    "16": "https://dd.sw.tn/api/baidu.com?size=16",
    "32": "https://dd.sw.tn/api/baidu.com?size=32",
    "64": "https://dd.sw.tn/api/baidu.com?size=64&format=png",
    "128": "https://dd.sw.tn/api/baidu.com?size=128&format=png"
  },
  "isSvg": false,
  "fromCache": true,
  "source": "html-link"
}

批量查询

用逗号分隔多个域名，一次返回所有结果：

https://dd.sw.tn/api/baidu.com,github.com,twitter.com

返回：

{
  "ok": true,
  "count": 3,
  "results": {
    "baidu.com": { "ok": true, "url": "https://dd.sw.tn/api/baidu.com", "isSvg": false },
    "github.com": { "ok": true, "url": "https://dd.sw.tn/api/github.com", "isSvg": true }
  }
}

缓存刷新

默认缓存 7 天。如需强制重新获取：

https://dd.sw.tn/api/baidu.com?refresh=1

HTML 嵌入示例

<img src="https://dd.sw.tn/api/baidu.com?size=32" alt="baidu.com favicon" />

API Key

当前未启用 Key 验证，所有人可免费使用。

启用后：

  • 无 Key：每 IP 每日 50 次
  • 有 Key：每 Key 每日 5000 次（可自定义）

请求时带上 key 参数：

https://dd.sw.tn/api/baidu.com?key=你的API密钥

超限时返回：

{ "ok": false, "error": "daily limit exceeded", "limit": 50, "used": 50 }

错误码

状态码 说明
200 成功
400 域名格式错误
403 域名被禁止（内网地址）
404 未找到该网站的图标
429 请求超限（API Key 验证开启时）
500 服务器内部错误