快速开始
请求成功返回 image/png，可直接作为 地址使用。若接口校验失败，会返回对应状态码与文本说明。仅访问 /api/get（不带 url）时返回服务健康文本。
GET
https://www.favicon.org.cn/api/get?url=TARGET_SITE_DOMAIN&size=128&key=YOUR_KEY
<img src="https://www.favicon.org.cn/api/get?url=TARGET_SITE_DOMAIN&size=128&key=YOUR_KEY" alt="Favicon of TARGET_SITE_DOMAIN" />
参数说明
url 必填
目标站点域名或 URL，例如 `apple.com`、`https://github.com`。
size 可选
输出尺寸支持 `16/32/48/64/96/128/256/512`。默认 `64`，传入不支持的值会自动回退到 `64`。
key 可选
API Key。默认需要有效密钥；仅当后台启用访客模式且配置了默认演示 Key 时可留空。
返回状态
- 200 请求成功，返回 `image/png` 图标数据。
- 400 参数错误：`url` 非法。
- 403 未授权或策略拒绝（如缺失/无效 Key、私网域名、白名单不匹配）。
- 404 目标站点未找到可用图标。
- 426 站点策略要求 HTTPS。
- 429 请求频率过高，请稍后重试。
- 500 服务内部错误（缓存路径/写入异常）。