Identitet och verifiering

API för logotypbilder

Visa företagets logotyp bredvid varje domän i din produkt. Anropa /v1/logo/ följt av en domän och få en kvadratisk PNG i rätt storlek, redo för en img-tagg, med rubriker som visar var den kommer ifrån. Du får cachelagra och lagra bilderna och leverera dem från dina egna servrar eller ditt CDN.

Category Identitet och verifiering
Slutpunkter 1
Nyckelfunktioner 4
Vanliga frågor 4

Används av människor på dessa företag

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

I drift Tjänstestatus

Kontrollera tjänstens aktuella status och dokumenterade felsvar innan du integrerar.

OpenAPI API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

1 000 Kostnadsfria krediter

Börja med 1 000 kostnadsfria krediter varje månad. Behöver du mer? Välj en månadsplan eller köp ett engångspaket.

Vad detta API hjälper dig att leverera

Använd sidan som en produktionsbrief: endpoints, exempel, responsform och workflow-delar som krävs för att koppla DomScan till din produkt.

Produktworkflows

Bädda in domänkontroller, DNS-intelligence, risksignaler eller berikning i onboarding, sök och interna verktyg.

Analystautomatisering

Ersätt upprepade manuella lookups med schemalagda jobb, alerts och reproducerbara utredningssteg.

Ren JSON-data

Använd förutsägbara fält, dokumenterade statuskoder och kreditkostnader istället för att skrapa leverantörssidor.

AI- och ops-verktyg

Mata agenter, dashboards, SOAR-playbooks och CRM:er via OpenAPI, SDK, Postman eller MCP.

Integrationsworkflow

En enkel väg från första request till repeterbar produktion.

1
Autentisera en gång

Skicka din API-nyckel med dokumenterad header och håll requests konsekventa mellan tjänster.

2
Fråga med exempel

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

3
Drifta och övervaka

Använd statuskoder, kreditkostnader och responsfält för retries, loggar och alerts.

Utvecklarkit

Gå från sidan till maskinläsbara docs, request-samlingar, SDK:er eller agentverktyg.

Parameter- och responskarta

Granska inputs, outputfält och statuskoder innan endpointen kopplas in i din klient.

Requestparametrar

Parameter

domain
Responsfält

Exempelsvar

successdatameta
Statustäckning

HTTP-statuskoder

401402

Slutpunkter

GET /v1/logo/:domain
Krediter: 1Autentisering: Autentisering krävs
domain

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

I drift Tjänstestatus

Kontrollera tjänstens aktuella status och dokumenterade felsvar innan du integrerar.

OpenAPI API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

1 000 Kostnadsfria krediter

Börja med 1 000 kostnadsfria krediter varje månad. Behöver du mer? Välj en månadsplan eller köp ett engångspaket.

Nyckelfunktioner

En riktig logotyp eller ett ärligt svar

Logotyperna kommer från det företaget själv publicerar: sin BIMI-maillogotyp, appikoner, touch-ikoner, logotyper i strukturerad data och favicons. Varje bild laddas ner och avkodas innan den returneras. När det inte finns någon logotyp får du ett 404-fel, eller med fallback=monogram en genererad bokstavsbild som alltid märks som genererad.

Anpassade för ditt gränssnitt

Välj valfri storlek från 16 till 512 pixlar, retina för dubbel upplösning, greyscale och theme=light eller theme=dark för att placera logotyper med låg kontrast på en bricka som syns mot din bakgrund. Bilderna är kvadratiska med transparent marginal.

Dina att cachelagra och behålla

Svaren har långlivade publika cache-rubriker, en ETag och Last-Modified. Webbläsare och ditt CDN kan behålla dem, och du får lagra filerna och leverera dem från dina egna servrar. Lägg till v= i en URL för att göra den oföränderlig.

Säkert att använda på en webbsida

Använd en publicerbar nyckel i parametern token så fungerar den bara från de webbplatser du anger, med gränser per nyckel och per besökare. Hemliga nycklar stannar på din server, i rubriken X-API-Key.

Exempelbegäran

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">

Exempelsvar

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

Vanliga frågor

Hur många krediter kostar en logotyp?

En kredit per begäran, även för logotyper som levereras från cachen, genererade bokstavsbilder, domäner utan logotyp och svar med 304 Not Modified. Begäranden som avvisas innan något arbete utförs, till exempel en ogiltig domän eller en nyckel som används från en webbplats som inte är tillåten, debiteras inte. Cachelagra bilden i stället för att hämta den vid varje sidvisning.

Får jag lagra logotyperna på mina egna servrar?

Ja. Du får cachelagra returnerade bilder, lagra dem och leverera dem från dina egna servrar eller ditt CDN. Logotyper förblir ägarnas varumärken, så använd dem för att identifiera företaget de tillhör.

Vad är skillnaden mellan hittades inte och otillgänglig?

Hittades inte betyder att webbplatsen och dess mailposter svarade och inte publicerar någon användbar logotyp; det svaret återanvänds i en timme. Otillgänglig betyder att webbplatsen blockerade begäran, var långsam eller svarade otydligt, så ingen slutsats drogs och du kan försöka igen några minuter senare. X-Logo-Status skiljer dem åt.

Hur vet jag var en logotyp kommer ifrån?

X-Logo-Source anger källan, till exempel bimi, manifest_icon, touch_icon eller favicon, och X-Logo-Verification visar att bilden har avkodats. En genererad bokstavsbild har alltid X-Logo-Source: generated och presenteras aldrig som en logotyp.

Relaterade verktyg och resurser

HTTP-statuskoder

Det här är de HTTP-statuskoder som du bör hantera, så att du kan skilja mellan lyckade svar, autentiseringsproblem, krediter, hastighetsgränser, saknade data och fel hos externa tjänster.

Obehörig 401

API-nyckel eller session saknas eller är ogiltig.

Betalning krävs 402

Det finns inte tillräckligt med krediter för att köra denna begäran.

Hämta en logotyp