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.
https://favicon.is/{domain}<img src="https://favicon.is/github.com" width="32" height="32" alt="GitHub">Sorgu parametreleri
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
| size | integer | 128 | Piksel cinsinden simge boyutu. 16, 32, 48, 64, 128 veya 256 olabilir; diğer değerler desteklenen en yakın boyuta yuvarlanır.?size=64 |
| larger | boolean | false | Yüksek çözünürlüklü bir simge (256 px) döndürür. size=256 ile aynıdır.?larger=true |
| original | boolean | false | Google’ın favicon önbelleğini atlar ve web sitesinin kendi HTML kodunda tanımlanan simgeyi okur.?original=true |
| download | boolean | false | Tarayı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.
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ünYanı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 -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: 3msYanı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 -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.
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 }
}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.