Question 1

Was ist ClearLogo?

Accepted Answer

ClearLogo ist eine Logo-API, die für jede Domain ein einzelnes, sauberes Bild zurückgibt. Im Gegensatz zu generischen Logo-Quellen konzentriert sich ClearLogo auf die Präsentation: Jede Antwort ist hintergrundabhängig, automatisch zugeschnitten und seitenverhältnisgerecht, damit Logos in Dashboards, CRMs, Unternehmenstabellen und anderen Produktoberflächen konsistent aussehen.

Question 2

Muss ich mich anmelden, um die API zu testen?

Accepted Answer

Nein. Sie können sofort anonyme Anfragen an https://api.clearlogo.dev/logo/{domain} für Tests mit geringem Volumen stellen – kein Schlüssel erforderlich. Für Produktionsverkehr benötigen Sie einen Browser-Schlüssel oder Server-Schlüssel aus dem Dashboard.

Question 3

Benötige ich einen Backend-Server, um ClearLogo zu verwenden?

Accepted Answer

Nein. Ein Browser-Schlüssel ermöglicht es Ihnen, Logo-URLs direkt in <img>-Tags aus Frontend-Code einzubetten. Anfragen werden durch Origin/Referer-Übereinstimmung gegen die erlaubten Domains validiert, die Sie für den Schlüssel konfigurieren. Verwenden Sie einen Server-Schlüssel nur, wenn Sie Authorization: Bearer-Authentifizierung von Ihrem Backend bevorzugen.

Question 4

Wo fange ich an?

Accepted Answer

Der schnellste Weg: Öffnen Sie den Playground, fügen Sie ein paar repräsentative Domains ein, und sehen Sie, wie die Ausgabe in Ihrer Benutzeroberfläche aussieht. Wenn Sie zufrieden sind, erstellen Sie einen Produktionsschlüssel im Dashboard und ersetzen Sie die URL in Ihrem Code.

Question 5

Was sind die besten Anwendungsfälle für ClearLogo?

Accepted Answer

ClearLogo ist eine gute Wahl überall dort, wo Logos nebeneinander angeordnet sind und visuelle Konsistenz wichtig ist – Unternehmenstabellen und Verzeichnisse, CRM-Kontolisten, Anreicherungs-UIs, Verkaufstools und interne Dashboards. Wenn Sie nur ein einmaliges Logo hinter einem serverseitigen Cache benötigen und Präsentationskonsistenz keine Rolle spielt, kann eine generische Quelle ausreichend sein.

Question 6

Was ist der Unterschied zwischen einem Browser-Schlüssel und einem Server-Schlüssel?

Accepted Answer

Ein Browser-Schlüssel (pk_…) ist sicher, um ihn in Frontend-Code und <img>-Tags zu versenden. Anfragen werden authentifiziert, indem der Origin- oder Referer-Header gegen die erlaubten Domains abgeglichen wird, die Sie konfigurieren. Ein Server-Schlüssel (sk_…) authentifiziert sich via Authorization: Bearer YOUR_KEY von Ihrem Backend und darf niemals dem Browser ausgesetzt sein.

Question 7

Wie beschränke ich meinen Browser-Schlüssel auf bestimmte Domains?

Accepted Answer

Im Dashboard öffnen Sie die Einstellungen des Schlüssels, aktivieren Sie Nur erlaubte Domains und fügen Sie Ihre Domains zeilenweise hinzu. Wildcard-Notation wie *.example.com wird für Subdomains unterstützt.

Question 8

Was passiert mit Anfragen ohne Referer-Header, nachdem ich Domain-Beschränkungen aktiviert habe?

Accepted Answer

Sie werden blockiert. Direkter Traffic und Anfragen, die mit Referrer-Policy: no-referrer oder same-origin gesendet werden, schlagen fehl, sobald Domain-Beschränkungen aktiv sind. Richtlinien, die funktionieren, sind strict-origin-when-cross-origin, origin, origin-when-cross-origin und unsafe-url. Sie können Ihr Setup überprüfen, indem Sie den Referer-Header bei img.logo.dev-Anfragen in der Registerkarte "Netzwerk" Ihres Browsers überprüfen, bevor Sie Beschränkungen aktivieren.

Question 9

Wie rotiere oder ersetze ich einen API-Schlüssel?

Accepted Answer

Erstellen Sie einen neuen Schlüssel im Dashboard, aktualisieren Sie Ihre Integration, um ihn zu verwenden, und löschen Sie dann den alten Schlüssel. Wenn Sie eine dringende Rotation benötigen, kontaktieren Sie support@clearlogo.dev.

Question 10

Welche Bildformate gibt ClearLogo zurück?

Accepted Answer

png ist die Standardeinstellung. Sie können webp oder jpeg über den format-Abfrageparameter anfordern. Wenn format weggelassen wird, wird die API vom Accept-Request-Header verhandelt – moderne Browser, die über <img> laden, erhalten WebP automatisch.

Question 11

Was bedeutet die Ausgabe "background-aware" (hintergrundabhängig)?

Accepted Answer

ClearLogo erkennt, ob das Logo einer Marke für einen farbigen oder dunklen Hintergrund gestaltet wurde, und bewahrt diesen Hintergrund im Antwortbild. Dies verhindert das häufige Problem von transparenten Logos, die auf hellen Oberflächen unterbrochen aussehen.

Question 12

Welche Größen sind verfügbar?

Accepted Answer

Der size-Parameter akzeptiert Zweierpotenzen: 16, 32, 48, 64, 96, 128, 192, 256, 512 und 1024 Pixel. Das Bild ist immer quadratisch. Der Standard ist 128 Pixel. Werte außerhalb dieser Liste werden auf den nächsten erlaubten Wert gerundet (bei Gleichstand wird der größere Wert gewählt).

Question 13

Was macht der `theme`-Parameter?

Accepted Answer

Das Setzen von theme=dark gibt die Dunkel-Hintergrund-Variante eines Logos zurück, wenn eine verfügbar ist. Wenn keine Dunkel-Variante existiert, greift die API auf die Standardversion zurück.

Question 14

Was sind die Rate Limits?

Accepted Answer

Limits variieren je nach Plan – siehe die Preisseite für Details. Die Pro-Schlüssel-Verwendung wird in X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset-Response-Headern zurückgegeben, damit Sie den Verbrauch in Echtzeit überwachen können.

Question 15

Was passiert, wenn ich mein Rate Limit überschreite?

Accepted Answer

Die API gibt HTTP 429 mit einem Retry-After-Header zurück, der angibt, wie viele Sekunden zu warten sind, bevor Sie erneut versuchen. Wir werden Sie kontaktieren, bevor wir weitere Maßnahmen ergreifen – der Service wird nicht ohne Warnung abgeschnitten.

Question 16

Wie überprüfe ich meine aktuelle Verwendung?

Accepted Answer

Die Echtzeit-Verwendung ist im Dashboard sichtbar. Sie können auch den X-RateLimit-Remaining-Header in jeder API-Antwort lesen.

Question 17

Ein Logo wird für eine Domain nicht angezeigt – was sollte ich überprüfen?

Accepted Answer

Arbeiten Sie diese Checkliste ab: (1) Bestätigen Sie, dass die Domain ein bloßer Hostname ohne Schema oder Pfad ist, z. B. github.com nicht https://github.com/; (2) überprüfen Sie, dass Ihr API-Schlüssel gültig und nicht abgelaufen ist; (3) wenn Domain-Beschränkungen aktiviert sind, überprüfen Sie, dass der Referer-Header gesendet wird; (4) überprüfen Sie den Response-Statuscode – 404 bedeutet, dass kein Logo für diese Domain gefunden wurde, 401 bedeutet ein Authentifizierungsproblem, 429 bedeutet Rate-Limit überschritten.

Question 18

Das Logo für eine Domain sieht falsch oder veraltet aus – was kann ich tun?

Accepted Answer

Kontaktieren Sie uns unter support@clearlogo.dev mit dem Domänennamen und einem Hinweis auf das Problem. Wir werden es überprüfen und das Asset aktualisieren.

Question 19

Ich erhalte einen 401-Fehler – was bedeutet das?

Accepted Answer

Ein 401 bedeutet, dass die Anfrage nicht authentifiziert wurde. Stellen Sie für Browser-Schlüssel sicher, dass der token-Abfrageparameter enthalten ist und dass der Origin/Referer-Header einer erlaubten Domain entspricht. Stellen Sie für Server-Schlüssel sicher, dass der Authorization: Bearer YOUR_KEY-Header vorhanden ist und der Schlüssel nicht gelöscht wurde.

Question 20

Logos werden in der Produktion geladen, aber nicht während der lokalen Entwicklung – wie behebe ich das?

Accepted Answer

Fügen Sie localhost (oder localhost:3000, localhost:5173, usw.) zu den erlaubten Domains Ihres Schlüssels im Dashboard hinzu. Die API stimmt mit dem exakten Origin überein, also fügen Sie den Port ein, wenn Ihr Dev-Server einen nicht-Standard-Port verwendet. Entfernen Sie lokale Einträge vor dem Verteilen des Schlüssels, oder erstellen Sie einen separaten Entwicklungsschlüssel.

Question 21

Ich sehe CORS-Fehler im Browser – wie behebe ich das?

Accepted Answer

Die API setzt permissive CORS-Header, daher deuten CORS-Fehler normalerweise auf einen fehlenden oder blockierten Referer-Header hin, anstatt auf ein echtes CORS-Problem. Überprüfen Sie die Referrer-Policy Ihrer Seite – Richtlinien wie no-referrer verhindern, dass der Referer-Header gesendet wird, was dazu führt, dass Anfragen fehlschlagen, wenn Domain-Beschränkungen aktiv sind. Überprüfen Sie auch das <img>-Tag selbst: Ein referrerpolicy="no-referrer"- oder referrerpolicy="same-origin"-Attribut auf dem Element überschreibt die Richtlinie auf Seitenebene und entfernt Referer aus dieser spezifischen Anfrage.

Question 22

Welche Pläne sind verfügbar?

Accepted Answer

ClearLogo bietet einen kostenlosen Plan für die Verwendung mit geringem Volumen und bezahlte Pläne für Produktionsverkehr. Siehe die Preisseite für aktuelle Plan-Details und Anfragenlimits.

Question 23

Wie upgrade ich meinen Plan?

Accepted Answer

Besuchen Sie das Dashboard und wählen Sie Upgrade aus Ihrer Plan-Karte. Sie werden zur Seite "Abrechnung" weitergeleitet, auf der Sie einen Plan auswählen und die Zahlung durchführen können.

Question 24

Kann ich mein Abonnement kündigen?

Accepted Answer

Ja. Sie können jederzeit vom Dashboard aus kündigen. Ihr Plan bleibt bis zum Ende des aktuellen Abrechnungszeitraums aktiv.

Hilfe & FAQ

Erste Schritte

API-Schlüssel & Authentifizierung

Ausgabe & Formatierung

Rate Limits & Verwendung

Fehlerbehebung

Abrechnung & Pläne

Haben Sie noch eine Frage?