Question 1

Qu'est-ce que ClearLogo ?

Accepted Answer

ClearLogo est une API de logo qui retourne une seule image propre et nette pour n'importe quel domaine. Contrairement aux sources de logo génériques, elle se concentre sur la présentation : chaque réponse est compatible avec le fond, auto-recadrée et ajustée en ratio pour que les logos soient cohérents dans les tableaux de bord, les CRM, les tableaux d'entreprises et autres surfaces de produit.

Question 2

Dois-je m'inscrire pour tester l'API ?

Accepted Answer

Non. Vous pouvez faire des demandes anonymes à https://api.clearlogo.dev/logo/{domain} immédiatement pour des tests à faible volume — aucune clé requise. Pour le trafic en production, vous aurez besoin d'une clé de navigateur ou d'une clé de serveur à partir du tableau de bord.

Question 3

Ai-je besoin d'un serveur backend pour utiliser ClearLogo ?

Accepted Answer

Non. Une clé de navigateur vous permet d'intégrer les URL de logo directement dans les balises <img> à partir du code frontend. Les demandes sont validées par correspondance Origin/Referer par rapport aux domaines autorisés que vous configurez sur la clé. Utilisez une clé de serveur uniquement si vous préférez l'authentification Authorization: Bearer à partir de votre backend.

Question 4

Par où commencer ?

Accepted Answer

Le chemin le plus rapide : ouvrez le playground, collez quelques domaines représentatifs et voyez à quoi ressemble la sortie dans votre interface. Une fois satisfait, créez une clé de production dans le tableau de bord et remplacez l'URL dans votre code.

Question 5

Quels sont les meilleurs cas d'usage pour ClearLogo ?

Accepted Answer

ClearLogo s'adapte bien partout où les logos sont côte à côte et où la cohérence visuelle est importante — tableaux d'entreprises et répertoires, listes de comptes CRM, interfaces d'enrichissement, outils de vente et tableaux de bord internes. Si vous n'avez besoin que d'un seul logo derrière un cache côté serveur et que la cohérence de présentation n'est pas une préoccupation, une source générique pourrait suffire.

Question 6

Quelle est la différence entre une clé de navigateur et une clé de serveur ?

Accepted Answer

Une clé de navigateur (pk_…) est sûre à expédier dans le code frontend et les balises <img>. Les demandes sont authentifiées en faisant correspondre l'en-tête Origin ou Referer avec les domaines autorisés que vous configurez. Une clé de serveur (sk_…) s'authentifie via Authorization: Bearer YOUR_KEY à partir de votre backend et ne doit jamais être exposée au navigateur.

Question 7

Comment puis-je restreindre ma clé de navigateur à des domaines spécifiques ?

Accepted Answer

Dans le tableau de bord, ouvrez les paramètres de la clé, activez Domaines autorisés uniquement, et ajoutez vos domaines un par ligne. La notation avec joker comme *.example.com est supportée pour les sous-domaines.

Question 8

Que se passe-t-il pour les demandes sans en-tête Referer après activation des restrictions de domaine ?

Accepted Answer

Elles sont bloquées. Le trafic direct et les demandes envoyées avec Referrer-Policy: no-referrer ou same-origin échoueront une fois les restrictions de domaine actives. Les stratégies qui fonctionnent incluent strict-origin-when-cross-origin, origin, origin-when-cross-origin et unsafe-url. Vous pouvez vérifier votre configuration en vérifiant l'en-tête Referer sur les demandes img.logo.dev dans l'onglet Réseau de votre navigateur avant d'activer les restrictions.

Question 9

Comment puis-je faire tourner ou remplacer une clé API ?

Accepted Answer

Créez une nouvelle clé dans le tableau de bord, mettez à jour votre intégration pour l'utiliser, puis supprimez l'ancienne clé. Si vous avez besoin d'une rotation urgente, contactez support@clearlogo.dev.

Question 10

Quels formats d'image ClearLogo retourne-t-il ?

Accepted Answer

png est la valeur par défaut. Vous pouvez demander webp ou jpeg via le paramètre de requête format. Quand format est omis, l'API négocie le contenu à partir de l'en-tête de demande Accept — les navigateurs modernes chargeant via <img> reçoivent WebP automatiquement.

Question 11

Que signifie une sortie « compatible avec le fond » ?

Accepted Answer

ClearLogo détecte si le logo d'une marque est conçu pour un fond coloré ou sombre et préserve ce fond dans l'image de réponse. Cela évite le problème courant des logos transparents qui semblent cassés sur les surfaces claires.

Question 12

Quelles tailles sont disponibles ?

Accepted Answer

Le paramètre size accepte les puissances de deux : 16, 32, 48, 64, 96, 128, 192, 256, 512 et 1024 pixels. L'image est toujours carrée. La valeur par défaut est 128 px. Les valeurs hors liste sont automatiquement arrondies à la taille permise la plus proche (en cas d'égalité, la valeur supérieure est choisie).

Question 13

Que fait le paramètre `theme` ?

Accepted Answer

Régler theme=dark retourne la variante du logo pour fond sombre quand elle est disponible. Si aucune variante sombre n'existe, l'API revient à la version standard.

Question 14

Quelles sont les limites de taux ?

Accepted Answer

Les limites varient selon le plan — consultez la page de tarification pour les détails. L'utilisation par clé est retournée dans les en-têtes de réponse X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset afin que vous puissiez surveiller la consommation en temps réel.

Question 15

Que se passe-t-il quand je dépasse ma limite de taux ?

Accepted Answer

L'API retourne HTTP 429 avec un en-tête Retry-After indiquant combien de secondes attendre avant de réessayer. Nous vous contacterons avant de prendre une action supplémentaire — le service n'est pas coupé sans avertissement.

Question 16

Comment puis-je vérifier mon utilisation actuelle ?

Accepted Answer

L'utilisation en temps réel est visible dans le tableau de bord. Vous pouvez également lire l'en-tête X-RateLimit-Remaining sur n'importe quelle réponse API.

Question 17

Un logo ne s'affiche pas pour un domaine — que dois-je vérifier ?

Accepted Answer

Parcourez cette liste : (1) confirmez que le domaine est un nom d'hôte nu sans schéma ni chemin, par exemple github.com et non https://github.com/ ; (2) vérifiez que votre clé API est valide et non expirée ; (3) si les restrictions de domaine sont activées, vérifiez que l'en-tête Referer est envoyé ; (4) vérifiez le code de statut de la réponse — 404 signifie qu'aucun logo n'a été trouvé pour ce domaine, 401 signifie un problème d'authentification, 429 signifie taux limité.

Question 18

Le logo pour un domaine semble incorrect ou obsolète — que puis-je faire ?

Accepted Answer

Contactez-nous à support@clearlogo.dev avec le nom de domaine et une note sur ce qui semble incorrect. Nous l'examinerons et mettrons à jour l'actif.

Question 19

Je reçois une erreur 401 — que signifie-t-elle ?

Accepted Answer

Un 401 signifie que la demande n'a pas été authentifiée. Pour les clés de navigateur, assurez-vous que le paramètre de requête token est inclus et que l'en-tête Origin/Referer correspond à un domaine autorisé. Pour les clés de serveur, assurez-vous que l'en-tête Authorization: Bearer YOUR_KEY est présent et que la clé n'a pas été supprimée.

Question 20

Les logos se chargent en production mais pas pendant le développement local — comment puis-je résoudre ce problème ?

Accepted Answer

Ajoutez localhost (ou localhost:3000, localhost:5173, etc.) aux domaines autorisés de votre clé dans le tableau de bord. L'API correspond à l'origine exacte, donc incluez le port si votre serveur de développement en utilise un non-standard. Supprimez les entrées locales avant de distribuer la clé, ou créez une clé de développement séparée.

Question 21

Je vois des erreurs CORS dans le navigateur — comment puis-je résoudre ce problème ?

Accepted Answer

L'API définit des en-têtes CORS permissifs, donc les erreurs CORS indiquent généralement un en-tête Referer manquant ou bloqué plutôt qu'un vrai problème CORS. Vérifiez la Referrer-Policy de votre page — des stratégies comme no-referrer empêchent l'en-tête Referer d'être envoyé, ce qui causera l'échec des demandes quand les restrictions de domaine sont actives. Vérifiez également la balise <img> elle-même : un attribut referrerpolicy="no-referrer" ou referrerpolicy="same-origin" sur l'élément remplace la stratégie au niveau de la page et supprime Referer de cette demande spécifique.

Question 22

Quels plans sont disponibles ?

Accepted Answer

ClearLogo propose un plan gratuit pour une utilisation à faible volume et des plans payants pour le trafic en production. Consultez la page de tarification pour les détails du plan actuel et les limites de demande.

Question 23

Comment puis-je mettre à niveau mon plan ?

Accepted Answer

Visitez le tableau de bord et sélectionnez Upgrade dans votre carte de plan. Vous serez dirigé vers la page de facturation où vous pouvez choisir un plan et effectuer le paiement.

Question 24

Puis-je annuler mon abonnement ?

Accepted Answer

Oui. Vous pouvez annuler à tout moment à partir du tableau de bord. Votre plan reste actif jusqu'à la fin de la période de facturation actuelle.

Aide & FAQ

Démarrage

Clés API & Authentification

Sortie & Formatage

Limites de taux & Utilisation

Dépannage

Facturation & Plans

Vous avez encore une question ?