Tożsamość i weryfikacja

API obrazów logo

Pokaż logo firmy obok każdej domeny w swoim produkcie. Wywołaj /v1/logo/ z domeną i otrzymaj kwadratowy plik PNG o odpowiednim rozmiarze, gotowy do znacznika img, z nagłówkami wskazującymi jego pochodzenie. Obrazy możesz zapisywać w pamięci podręcznej, przechowywać i udostępniać z własnych serwerów lub własnego CDN.

Zobacz dokumentację Poznaj wszystkie API

Punkty końcowe Aktywny

GET /v1/logo/:domain

Przykładowe żądanie

curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
  "https://domscan.net/v1/logo/stripe.com?size=128&retina=true"

Przykładowa odpowiedź 200 OK

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

Przykładowe żądanie GET /v1/logo/stripe.com

Kluczowe funkcje 4

Często zadawane pytania 4

Kody statusu HTTP 401 / 402

Kategoria Tożsamość i weryfikacja

Punkty końcowe 1

Kluczowe funkcje 4

Często zadawane pytania 4

Używany przez ludzi w tych firmach

Sygnały zaufania przed integracją

Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.

Aktywna Status usługi

Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.

OpenAPI Materiały API

Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.

Klucze API Chroniony dostęp

Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.

1000 Bezpłatne kredyty

Zacznij z 1 000 bezpłatnych kredytów co miesiąc. Potrzebujesz więcej? Wybierz plan miesięczny lub kup jednorazowy pakiet.

Co ta API pomaga wdrożyć

Użyj tej strony jako briefu produkcyjnego: endpointy, przykłady, kształt odpowiedzi i elementy workflow potrzebne do podłączenia DomScan do produktu.

Workflow produktu

Osadzaj sprawdzanie domen, DNS intelligence, sygnały ryzyka lub enrichment w onboardingu, wyszukiwarce i narzędziach wewnętrznych.

Automatyzacja analityków

Zastąp powtarzalne ręczne lookupy zadaniami cyklicznymi, alertami i odtwarzalnymi krokami dochodzenia.

Czyste dane JSON

Używaj przewidywalnych pól, udokumentowanych kodów statusu i kosztów kredytów zamiast scrapować strony dostawców.

AI i narzędzia ops

Zasilaj agentów, dashboardy, playbooki SOAR i CRMy przez OpenAPI, SDK, Postman lub MCP.

Workflow integracji

Prosta ścieżka od pierwszego requestu do powtarzalnego użycia produkcyjnego.

Uwierzytelnij raz

Wyślij klucz API w udokumentowanym nagłówku i utrzymuj spójne requesty między usługami.

Odpytuj z przykładami

Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.

Operuj i monitoruj

Używaj kodów statusu, kosztów kredytów i pól odpowiedzi do retries, logów i alertów.

Zestaw developerski

Przejdź z tej strony do dokumentacji machine-readable, kolekcji requestów, SDK lub narzędzi agentowych.

Schemat OpenAPI

Generuj klientów lub sprawdzaj każdy kształt requestu i odpowiedzi.

Kolekcja Postman

Importuj gotowe requesty do testów manualnych i przekazania zespołowi.

SDK i CLI

Używaj utrzymywanych pakietów i workflow command-line zamiast pisać boilerplate.

Integracja MCP

Udostępniaj domain intelligence agentom AI i wewnętrznym asystentom.

Mapa parametrów i odpowiedzi

Przejrzyj inputy, pola outputu i kody statusu przed podłączeniem endpointu do klienta.

Parametry requestu

Parametr

domain

Pola odpowiedzi

Przykładowa odpowiedź

successdatameta

Zakres statusów

Kody statusu HTTP

401402

Punkty końcowe

GET /v1/logo/:domain

Kredyty: 1Uwierzytelnianie: Uwierzytelnienie required

domain

Sygnały zaufania przed integracją

Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.

Aktywna Status usługi

Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.

OpenAPI Materiały API

Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.

Klucze API Chroniony dostęp

Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.

1000 Bezpłatne kredyty

Zacznij z 1 000 bezpłatnych kredytów co miesiąc. Potrzebujesz więcej? Wybierz plan miesięczny lub kup jednorazowy pakiet.

Kluczowe funkcje

Prawdziwe logo albo uczciwa odpowiedź

Logo pochodzą z tego, co firma sama publikuje: jej logo pocztowe BIMI, ikony aplikacji, ikony dotykowe, logo w danych strukturalnych i favicony. Każdy obraz jest pobierany i dekodowany przed zwróceniem. Gdy logo nie ma, dostajesz błąd 404 albo, z fallback=monogram, wygenerowany obraz z literą, zawsze oznaczony jako wygenerowany.

W rozmiarze dopasowanym do interfejsu

Wybierz dowolny rozmiar od 16 do 512 pikseli, retina dla podwójnej gęstości, greyscale oraz theme=light lub theme=dark, aby umieścić mało kontrastowe logo na kafelku, który pozostaje widoczny na Twoim tle. Obrazy są kwadratowe, z przezroczystym marginesem.

Możesz je zapisać i zachować

Odpowiedzi zawierają długotrwałe publiczne nagłówki pamięci podręcznej, ETag i Last-Modified. Przeglądarki i Twój CDN mogą je przechowywać, a Ty możesz zapisywać pliki i udostępniać je z własnych serwerów. Dodaj v= do adresu URL, aby uczynić go niezmiennym.

Bezpieczne na stronie internetowej

Użyj klucza publikowalnego w parametrze token, a będzie działał tylko z witryn, które wskażesz, z limitami na klucz i na odwiedzającego. Klucze tajne zostają na Twoim serwerze, w nagłówku X-API-Key.

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Często zadawane pytania

Ile kredytów kosztuje logo?

Jeden kredyt za żądanie, także za logo podane z pamięci podręcznej, wygenerowane obrazy z literą, domeny bez logo i odpowiedzi 304 Not Modified. Żądania odrzucone przed jakąkolwiek obróbką, na przykład z nieprawidłową domeną lub z kluczem użytym w niedozwolonej witrynie, nie są naliczane. Zapisz obraz w pamięci podręcznej zamiast pobierać go przy każdym wyświetleniu strony.

Czy mogę przechowywać logo na własnych serwerach?

Tak. Możesz zapisywać zwrócone obrazy w pamięci podręcznej, przechowywać je i udostępniać z własnych serwerów lub własnego CDN. Logo pozostają znakami towarowymi swoich właścicieli, więc używaj ich do oznaczania firmy, do której należą.

Jaka jest różnica między „nie znaleziono” a „niedostępne”?

„Nie znaleziono” oznacza, że witryna i jej rekordy pocztowe odpowiedziały i nie publikują użytecznego logo; ta odpowiedź jest używana ponownie przez godzinę. „Niedostępne” oznacza, że witryna zablokowała żądanie, odpowiadała wolno lub niejasno, więc nie wyciągnięto żadnego wniosku i możesz spróbować ponownie za kilka minut. Rozróżnia je nagłówek X-Logo-Status.

Skąd wiem, skąd pochodzi logo?

X-Logo-Source wskazuje źródło, na przykład bimi, manifest_icon, touch_icon lub favicon, a X-Logo-Verification informuje, że obraz został zdekodowany. Wygenerowany obraz z literą zawsze ma X-Logo-Source: generated i nigdy nie jest przedstawiany jako logo.

Narzędzia pokrewne i zasoby

Kody statusu HTTP

Oto kody statusu HTTP, które należy obsługiwać, aby odróżnić udane odpowiedzi, problemy z uwierzytelnianiem, kredyty, limity żądań, brakujące dane i błędy usług nadrzędnych.

Nieautoryzowany 401

Brakuje klucza API lub sesji albo są one nieprawidłowe.

Wymagana płatność 402

Za mało kredytów, aby wykonać to żądanie.

Pobierz logo

Zacznij za darmo Zobacz dokumentację