Question 1

Что такое ClearLogo?

Accepted Answer

ClearLogo — это API для логотипов, который возвращает единое чистое изображение для любого домена. В отличие от универсальных источников логотипов, он сосредоточен на представлении: каждый ответ учитывает фон, автоматически обрезается и масштабируется так, чтобы логотипы выглядели согласованно в панелях инструментов, CRM-системах, таблицах компаний и других поверхностях продукта.

Question 2

Нужно ли регистрироваться, чтобы попробовать API?

Accepted Answer

Нет. Вы можете сразу отправить анонимные запросы на https://api.clearlogo.dev/logo/{domain} для тестирования с низким объёмом — ключ не требуется. Для производственного трафика вам потребуется ключ браузера или серверный ключ из панели управления.

Question 3

Нужен ли мне внутренний сервер для использования ClearLogo?

Accepted Answer

Нет. Ключ браузера позволяет вам встраивать URL логотипов непосредственно в теги <img> из кода интерфейса. Запросы проверяются путём сопоставления Origin/Referer с разрешёнными доменами, которые вы настраиваете на ключе. Используйте серверный ключ только если вы предпочитаете аутентификацию Authorization: Bearer с вашего сервера.

Question 4

С чего начать?

Accepted Answer

Самый быстрый способ: откройте playground, вставьте несколько репрезентативных доменов и посмотрите, как выглядит результат в вашем интерфейсе. Когда вы будете довольны результатом, создайте ключ для производства в панели управления и подставьте URL в ваш код.

Question 5

Какие лучшие варианты использования для ClearLogo?

Accepted Answer

ClearLogo хорошо подходит везде, где логотипы расположены рядом и важна визуальная согласованность — таблицы и каталоги компаний, списки учётных записей в CRM, интерфейсы обогащения данных, инструменты продаж и внутренние панели инструментов. Если вам нужен только один логотип за серверным кэшем и согласованность представления не является критичной, может быть достаточно универсального источника.

Question 6

В чём разница между ключом браузера и серверным ключом?

Accepted Answer

Ключ браузера (pk_…) безопасно использовать в коде интерфейса и в тегах <img>. Запросы аутентифицируются путём сопоставления заголовка Origin или Referer с разрешёнными доменами, которые вы настраиваете. Серверный ключ (sk_…) аутентифицируется через Authorization: Bearer YOUR_KEY с вашего сервера и никогда не должен быть доступен браузеру.

Question 7

Как ограничить ключ браузера определёнными доменами?

Accepted Answer

В панели управления откройте параметры ключа, включите Только разрешённые домены и добавьте ваши домены по одному на строку. Поддерживается подстановочная запись вроде *.example.com для поддоменов.

Question 8

Что произойдёт с запросами без заголовка Referer после включения ограничений по доменам?

Accepted Answer

Они будут заблокированы. Прямой трафик и запросы, отправленные с Referrer-Policy: no-referrer или same-origin, будут отклонены после активации ограничений по доменам. Политики, которые работают: strict-origin-when-cross-origin, origin, origin-when-cross-origin и unsafe-url. Вы можете проверить вашу настройку, проверив наличие заголовка Referer в запросах img.logo.dev на вкладке Network браузера перед включением ограничений.

Question 9

Как обновить или заменить ключ API?

Accepted Answer

Создайте новый ключ в панели управления, обновите вашу интеграцию для использования его, затем удалите старый ключ. Если вам нужна срочная ротация, свяжитесь с support@clearlogo.dev.

Question 10

Какие форматы изображений возвращает ClearLogo?

Accepted Answer

По умолчанию используется png. Вы можете запросить webp или jpeg через параметр запроса format. Когда format не указан, API согласует формат на основе заголовка запроса Accept — современные браузеры, загружающие через тег <img>, автоматически получают WebP.

Question 11

Что означает «с учётом фона»?

Accepted Answer

ClearLogo определяет, предназначен ли логотип бренда для цветного или тёмного фона, и сохраняет этот фон в изображении ответа. Это предотвращает распространённую проблему прозрачных логотипов, которые выглядят сломанными на светлых поверхностях.

Question 12

Какие размеры доступны?

Accepted Answer

Параметр size принимает степени двойки: 16, 32, 48, 64, 96, 128, 192, 256, 512 и 1024 пикселей. Изображение всегда квадратное. По умолчанию используется 128 пикселей. Значения за пределами этого списка автоматически округляются до ближайшего допустимого (при равном расстоянии выбирается большее значение).

Question 13

Что делает параметр `theme`?

Accepted Answer

Установка theme=dark возвращает вариант логотипа для тёмного фона, если он доступен. Если тёмный вариант не существует, API возвращает стандартную версию.

Question 14

Какие ограничения скорости?

Accepted Answer

Ограничения варьируются в зависимости от плана — см. страницу прайсинга для деталей. Использование в расчёте на ключ возвращается в заголовках ответа X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset, так что вы можете отслеживать потребление в реальном времени.

Question 15

Что происходит, когда я превышаю свой лимит скорости?

Accepted Answer

API возвращает HTTP 429 с заголовком Retry-After, указывающим количество секунд ожидания перед повторным попыткой. Мы свяжемся с вами перед принятием любых дальнейших действий — служба не отключается без предупреждения.

Question 16

Как проверить моё текущее использование?

Accepted Answer

Текущее использование видно в панели управления. Вы также можете прочитать заголовок X-RateLimit-Remaining в любом ответе API.

Question 17

Логотип не отображается для домена — что проверить?

Accepted Answer

Пройдите эту контрольную таблицу: (1) убедитесь, что домен — это простое имя хоста без схемы или пути, например github.com, а не https://github.com/; (2) проверьте, что ваш ключ API действителен и не истёк; (3) если ограничения по доменам включены, убедитесь, что отправляется заголовок Referer; (4) проверьте код статуса ответа — 404 означает, что логотип не найден для этого домена, 401 означает проблему аутентификации, 429 означает ограничение скорости.

Question 18

Логотип для домена выглядит неправильно или устарел — что я могу сделать?

Accepted Answer

Свяжитесь с нами по адресу support@clearlogo.dev с указанием имени домена и примечанием о том, что выглядит неправильно. Мы рассмотрим это и обновим ресурс.

Question 19

Я получаю ошибку 401 — что это означает?

Accepted Answer

Ошибка 401 означает, что запрос не был аутентифицирован. Для ключей браузера убедитесь, что включён параметр запроса token и что заголовок Origin/Referer соответствует разрешённому домену. Для серверных ключей убедитесь, что присутствует заголовок Authorization: Bearer YOUR_KEY и что ключ не был удалён.

Question 20

Логотипы загружаются в production, но не при локальной разработке — как это исправить?

Accepted Answer

Добавьте localhost (или localhost:3000, localhost:5173 и т. д.) в разрешённые домены вашего ключа в панели управления. API сопоставляет точное происхождение, поэтому включите порт, если ваш сервер разработки использует нестандартный порт. Удалите локальные записи перед распространением ключа или создайте отдельный ключ разработки.

Question 21

Я вижу ошибки CORS в браузере — как это исправить?

Accepted Answer

API устанавливает разрешительные заголовки CORS, поэтому ошибки CORS обычно указывают на отсутствующий или заблокированный заголовок Referer, а не на истинную проблему CORS. Проверьте Referrer-Policy вашей страницы — политики вроде no-referrer предотвращают отправку заголовка Referer, что вызовет ошибки запросов при активных ограничениях по доменам. Также проверьте сам тег <img>: атрибут referrerpolicy="no-referrer" или referrerpolicy="same-origin" переопределяет политику на уровне страницы и удаляет Referer из этого конкретного запроса.

Question 22

Какие планы доступны?

Accepted Answer

ClearLogo предлагает бесплатный план для использования с низким объёмом и платные планы для production-трафика. См. страницу прайсинга для текущих деталей плана и лимитов запросов.

Question 23

Как обновить мой план?

Accepted Answer

Посетите панель управления и выберите Обновить из карточки вашего плана. Вас перенаправит на страницу выставления счётов, где вы можете выбрать план и завершить платёж.

Question 24

Могу ли я отменить мою подписку?

Accepted Answer

Да. Вы можете отменить в любой момент из панели управления. Ваш план остаётся активным до конца текущего периода выставления счётов.

Справка и FAQ

Начало работы

Ключи API и аутентификация

Вывод и форматирование

Ограничения скорости и использование

Устранение неполадок

Выставление счётов и планы

Остались вопросы?