İçeriğe geç
Favicon.is

API belgeleri

Favicon.is, herhangi bir web sitesinin favicon’unu görsel olarak döndüren basit bir HTTP API’sidir. Yönetmeniz gereken anahtar, SDK veya istek sınırı başlığı yoktur.

Uç nokta

Alan adını yol olarak kullanıp bir GET isteği gönderin. Yanıt gövdesi doğrudan görselin kendisidir; bu yüzden URL’yi bir <img> etiketinde doğrudan kullanabilirsiniz.

GEThttps://favicon.is/{domain}
Örnek
<img src="https://favicon.is/github.com" width="32" height="32" alt="GitHub">
GitHub faviconGitHub favicon (256 px)

Sorgu parametreleri

ParametreTürVarsayılanAçıklama
sizeinteger128Piksel cinsinden simge boyutu. 16, 32, 48, 64, 128 veya 256 olabilir; diğer değerler desteklenen en yakın boyuta yuvarlanır.?size=64
largerbooleanfalseYüksek çözünürlüklü bir simge (256 px) döndürür. size=256 ile aynıdır.?larger=true
originalbooleanfalseGoogle’ın favicon önbelleğini atlar ve web sitesinin kendi HTML kodunda tanımlanan simgeyi okur.?original=true
downloadbooleanfalseTarayıcıların simgeyi dosya olarak indirmesi için bir Content-Disposition başlığı gönderir.?download=1

Kabul edilen girdiler

Yalın bir alan adı, bir alt alan adı, tam bir URL veya uluslararası bir alan adı gönderebilirsiniz. Protokoller, www., portlar, yollar ve sorgu dizeleri otomatik olarak kaldırılır; alan adı büyük/küçük harf ayrımı yapılmadan eşleştirilir.

Örnek
https://favicon.is/github.com
https://favicon.is/docs.github.com
https://favicon.is/https://github.com/features/actions
https://favicon.is/WWW.GitHub.com:443
https://favicon.is/bücher.de
https://favicon.is/例子.中国

IANA TLD’leriyle alan adı doğrulama

Favicon.is yalnızca uzantısı IANA Kök Bölge Veritabanında delege edilmiş bir üst düzey alan adı (TLD) olan alan adları için simge getirir. .local, .test gibi diğer uzantılar veya yazım hataları içeren istekler, hiçbir sunucuyla iletişime geçilmeden anında varsayılan simgeyle yanıtlanır.

Desteklenen tüm TLD’leri görün

Yanıt

Başarılı bir istek, görselle birlikte HTTP 200 döndürür (genellikle PNG, bazen ICO veya SVG). Hiçbir simge bulunamazsa yine varsayılan simgeyle birlikte HTTP 200 alırsınız; böylece sayfanızda asla bozuk bir görsel görünmez.

cURL
$ curl -I https://favicon.is/github.com

HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
access-control-allow-origin: *
etag: "8c1f3b6a2d4e5f60718293a4"
x-source: cache-r2
x-response-time: 3ms

Yanıt başlıkları

Content-Type
Görsel formatı: image/png, image/x-icon, image/svg+xml, image/jpeg, image/gif veya image/webp.
Cache-Control
Simgeler tarayıcılar ve CDN’ler tarafından bir gün önbelleğe alınabilir ve bir hafta boyunca arka planda yeniden doğrulanabilir.
X-Source
Simgenin nereden geldiği: cache-edge, cache-r2, google, live veya default.
X-Reason
Yalnızca varsayılan simgede bulunur. Nedenini açıklar: invalid-domain, unsupported-tld, not-found veya failure-cache.
X-Response-Time
İsteğin bizim tarafımızda ne kadar sürdüğü.
Access-Control-Allow-Origin
Access-Control-Allow-Origin: * sayesinde simgeleri bir canvas üzerine çizebilir veya herhangi bir kaynaktan (origin) getirebilirsiniz.

Önbellek ve güncellik

Her simge Cloudflare R2’de ve onu sunan veri merkezinin edge önbelleğinde depolanır. Tekrarlanan istekler genellikle birkaç milisaniye sürer.

Depolanan simgeler yedi gün sonra arka planda yenilenir; böylece logosunu değiştiren bir site, kimseyi yavaşlatmadan otomatik olarak güncellenir.

Bir sitenin hiç simgesi yoksa, siteyi tekrarlanan sorgularla yormamak için bu sonuç bir saat boyunca hatırlanır.

Varsayılan simge

Hiçbir simge bulunamadığında API bu nötr yer tutucuyu döndürür. Bunu tespit etmek isterseniz X-Source başlığında default değerini kontrol edin.

cURL
$ curl -I https://favicon.is/example.invalid

HTTP/2 200
content-type: image/svg+xml
x-source: default
x-reason: unsupported-tld

İnceleme API’si (JSON)

Favicon kontrol aracı, bir sitenin tanımladığı tüm simgeleri (link etiketleri, web uygulaması manifesti ve /favicon.ico) gerçek piksel boyutlarıyla birlikte listeleyen bir JSON uç noktasıyla çalışır.

JSON
GET https://favicon.is/api/inspect?domain=github.com

{
  "domain": "github.com",
  "url": "https://github.com/",
  "title": "GitHub · Build and ship software on a single, collaborative platform",
  "reachable": true,
  "icons": [
    {
      "href": "https://github.githubassets.com/favicons/favicon.svg",
      "rel": "icon",
      "type": "image/svg+xml",
      "source": "link",
      "ok": true,
      "contentType": "image/svg+xml",
      "width": 32,
      "height": 32
    }
  ],
  "manifest": { "href": "https://github.com/manifest.json", "ok": true, "icons": [ … ] },
  "checks": { "ico": true, "svg": true, "appleTouch": true, "manifest": true, "large": true }
}
Favicon Kontrolü

Adil kullanım

Görsel uç noktası ücretsizdir ve normal kullanım için katı bir sınırı yoktur. İnceleme API’si, IP adresi başına dakikada 30 istekle sınırlıdır. Günde milyonlarca istek göndermeyi planlıyorsanız lütfen önce bizimle iletişime geçin.