Руководство покупателя
На что разработчики должны действительно обратить внимание в API логотипа компании
Большинство API логотипов решают проблему поиска. Очень мало решают презентацию. Если ваш продукт отображает логотипы в таблицах, карточках, каталогах или внутренних инструментах, настоящий вопрос заключается в том, можно ли использовать результат внутри пользовательского интерфейса.
Большинство API логотипов решают проблему поиска. Более сложная проблема — это презентация: панели инструментов, CRM и списки учетных записей остаются визуально согласованными только когда каждый логотип поступает с осведомленностью о фоне, автоматически обрезанный и с соотношением сторон.
Четыре вещи, которые действительно важны
- Обработка фона — когда существует фон бренда, вывод должен его уважать.
- Пробелы и обрезка — логотипы не должны тратить место впустую или казаться смещенными от центра.
- Согласованность соотношения — один слот пользовательского интерфейса не должен производить разный визуальный вес для каждого бренда.
- Путь интеграции — веб-приложениям нужен процесс, который работает без принуждения сервера в цикл.
Где ClearLogo имеет свою позицию
ClearLogo расставляет приоритеты удобного вывода и потока с открытым ключом, удобного для браузера, что делает его хорошим выбором для панелей инструментов, CRM, инструментов обогащения и внутренних поверхностей продуктов.
Пример запроса
GET https://api.clearlogo.dev/logo/example.com?size=128&content=80
<img
src="https://api.clearlogo.dev/logo/example.com?token=YOUR_BROWSER_KEY"
alt="Example company logo"
/>
Лучшие случаи использования
- Таблицы и справочники компаний
- Инструменты CRM и продаж
- Списки учетных записей внутри панелей инструментов
- Веб-приложения, которым нужны URL логотипов без пользовательской службы подписи
FAQ
Что означает "вывод, осведомленный о фоне"?
ClearLogo определяет, ожидает ли логотип бренда цветной или темный фон, и сохраняет этот фон в ответе — вместо того чтобы всегда возвращать прозрачный PNG, который может выглядеть сломанным на светлых поверхностях.
Мне нужен бэкенд для использования ClearLogo?
Нет. Ключ браузера авторизует запросы через совпадение Origin/Referer, поэтому вы можете поместить URL логотипов прямо в теги <img> из кода интерфейса. Используйте ключ сервера только когда вам нужна аутентификация Bearer-токена из вашего бэкенда.
Какие форматы логотипов возвращает ClearLogo?
PNG по умолчанию, с webp и jpeg доступными через параметр format или автоматическое согласование контента из заголовка Accept. Современные браузеры автоматически получают WebP.
Когда я должен выбрать ClearLogo вместо универсального источника логотипа?
Когда логотипы находятся рядом в одном слоте пользовательского интерфейса — панели инструментов, CRM, списки учетных записей, поверхности обогащения — соотношение сторон и обработка фона это отличительные черты.
Используйте playground в качестве теста покупки
Если несколько репрезентативных доменов уже выглядят чище в ваших макетах пользовательского интерфейса, вы намного ближе к реальному решению, чем по маркерам функций.