Kimlik ve Doğrulama

Logo görseli API'si

Ürününüzdeki her alan adının yanında şirket logosunu gösterin. /v1/logo/ ve ardından bir alan adı isteyin; boyutlandırılmış, img etiketine hazır, kaynağını belirten başlıklarla gelen kare bir PNG alın. Görselleri önbelleğe alabilir, saklayabilir ve kendi sunucularınızdan veya CDN'inizden sunabilirsiniz.

Kategori Kimlik ve Doğrulama
Uç Noktalar 1
Temel Özellikler 4
Sık sorulan sorular 4

Bu şirketlerdeki kişiler tarafından kullanılıyor

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Canlı Hizmet durumu

Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.

OpenAPI API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

1.000 Ücretsiz krediler

Her ay 1.000 ücretsiz krediyle başlayın. Daha fazlası mı lazım? Aylık bir plan seçin veya tek seferlik bir paket satın alın.

Bu API neyi yayına almanıza yardımcı olur

Bu sayfayı üretim özeti olarak kullanın: endpointler, örnekler, yanıt yapısı ve DomScan’i ürününüze bağlamak için gereken workflow parçaları.

Ürün workflow’ları

Domain kontrollerini, DNS istihbaratını, risk sinyallerini veya zenginleştirmeyi onboarding, arama ve dahili araçlara gömün.

Analist otomasyonu

Tekrarlanan manuel sorguları planlı işler, uyarılar ve yeniden üretilebilir araştırma adımlarıyla değiştirin.

Temiz JSON verisi

Sağlayıcı sayfalarını kazımak yerine öngörülebilir alanlar, belgelenmiş durum kodları ve kredi maliyetleri kullanın.

AI ve ops araçları

OpenAPI, SDK, Postman veya MCP üzerinden agent’ları, panoları, SOAR playbook’larını ve CRM’leri besleyin.

Entegrasyon workflow’u

İlk istekten tekrarlanabilir üretim kullanımına giden basit yol.

1
Bir kez doğrulayın

API anahtarınızı belgelenmiş header ile gönderin ve servisler arasında istekleri tutarlı tutun.

2
Örneklerle sorgulayın

curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.

3
İşletin ve izleyin

Retry, log ve uyarılar için durum kodlarını, kredi maliyetlerini ve yanıt alanlarını kullanın.

Geliştirici kiti

Bu sayfadan makine tarafından okunabilir dokümanlara, istek koleksiyonlarına, SDK’lere veya agent araçlarına geçin.

Parametre ve yanıt haritası

Endpoint’i client’ınıza bağlamadan önce girdileri, çıktı alanlarını ve durum kodlarını tarayın.

İstek parametreleri

Parametre

domain
Yanıt alanları

Örnek yanıt

successdatameta
Durum kapsamı

HTTP durum kodları

401402

Uç Noktalar

GET /v1/logo/:domain
Kredi: 1Kimlik Doğrulama: Kimlik dogrulama gerekli
domain

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Canlı Hizmet durumu

Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.

OpenAPI API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

1.000 Ücretsiz krediler

Her ay 1.000 ücretsiz krediyle başlayın. Daha fazlası mı lazım? Aylık bir plan seçin veya tek seferlik bir paket satın alın.

Temel Özellikler

Gerçek bir logo ya da dürüst bir yanıt

Logolar şirketin kendi yayımladıklarından gelir: BIMI e-posta logosu, uygulama simgeleri, dokunmatik simgeler, yapılandırılmış veri logoları ve favicon'lar. Her görsel döndürülmeden önce indirilir ve çözülür. Logo yoksa 404 alırsınız veya fallback=monogram ile her zaman oluşturulmuş olarak etiketlenen bir harf görseli elde edersiniz.

Arayüzünüze göre boyutlandırılmış

16 ile 512 piksel arasında dilediğiniz boyutu, çift yoğunluk için retina'yı, greyscale'i ve theme=light veya theme=dark seçeneklerini kullanın; düşük kontrastlı logolar arka planınızda görünür kalan bir karoya yerleştirilir. Görseller şeffaf dolgulu karelerdir.

Önbelleğe alıp saklamak size kalmış

Yanıtlar uzun ömürlü genel önbellek başlıkları, bir ETag ve Last-Modified taşır. Tarayıcılar ve CDN'iniz bunları saklayabilir; dosyaları depolayıp kendi sunucularınızdan sunabilirsiniz. Bir URL'yi değişmez yapmak için v= ekleyin.

Web sayfasında güvenle kullanılır

token parametresinde yayımlanabilir bir anahtar kullanın; yalnızca belirttiğiniz web sitelerinden çalışır ve anahtar başına ile ziyaretçi başına sınırlar uygulanır. Gizli anahtarlar sunucunuzda, X-API-Key başlığında kalır.

Örnek istek

GET /v1/logo/stripe.com bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
  "https://domscan.net/v1/logo/stripe.com?size=128&retina=true"
html
<img src="https://domscan.net/v1/logo/stripe.com?size=64&token=pk_YOUR_PUBLISHABLE_KEY" width="64" height="64" alt="Stripe">

Örnek yanıt

200 OK json
HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
etag: "9f2c4e1a7b3d5c60-256-c"
x-logo-status: found
x-logo-source: touch_icon
x-logo-verification: decoded
x-logo-source-format: png
x-logo-native-size: 180x180
x-credits-remaining: 4999

Sık sorulan sorular

Bir logo kaç kredi tutar?

İstek başına bir kredi; önbellekten sunulan logolar, oluşturulmuş harf görselleri, logosu olmayan alan adları ve 304 Not Modified yanıtları da dahildir. Geçersiz bir alan adı veya izin verilmeyen bir sitede kullanılan anahtar gibi, herhangi bir işlem yapılmadan reddedilen istekler ücretlendirilmez. Görseli her sayfa görüntülemesinde almak yerine önbelleğe alın.

Logoları kendi sunucularımda saklayabilir miyim?

Evet. Döndürülen görselleri önbelleğe alabilir, saklayabilir ve kendi sunucularınızdan veya CDN'inizden sunabilirsiniz. Logolar sahiplerinin ticari markası olmaya devam eder; bu yüzden onları yalnızca ait oldukları şirketi belirtmek için kullanın.

Bulunamadı ile kullanılamıyor arasındaki fark nedir?

Bulunamadı, web sitesinin ve e-posta kayıtlarının yanıt verdiği ve kullanılabilir bir logo yayımlamadığı anlamına gelir; bu yanıt bir saat boyunca yeniden kullanılır. Kullanılamıyor ise web sitesinin isteği engellediği, yavaş kaldığı veya belirsiz yanıt verdiği anlamına gelir; bu yüzden bir sonuca varılmaz ve birkaç dakika sonra tekrar deneyebilirsiniz. İkisini X-Logo-Status ayırt eder.

Bir logonun nereden geldiğini nasıl anlarım?

X-Logo-Source, bimi, manifest_icon, touch_icon veya favicon gibi kaynağı belirtir; X-Logo-Verification ise görselin çözüldüğünü bildirir. Oluşturulmuş bir harf görselinde her zaman X-Logo-Source: generated bulunur ve asla logo olarak sunulmaz.

İlgili araçlar ve kaynaklar

HTTP durum kodları

İstemcinizin işlemesi gereken HTTP durum kodları şunlardır; böylece başarılı yanıtları, kimlik doğrulama sorunlarını, kredileri, hız sınırlarını, eksik verileri ve üst kaynak hatalarını birbirinden ayırabilirsiniz.

Yetkisiz 401

API anahtarı veya oturum eksik ya da geçersiz.

Ödeme Gerekli 402

Bu isteği çalıştırmak için yeterli krediniz yok.