# На что разработчики должны действительно обратить внимание в API логотипа компании

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

## Четыре вещи, которые действительно важны

- **Обработка фона** — когда существует фон бренда, вывод должен его уважать.
- **Пробелы и обрезка** — логотипы не должны тратить место впустую или казаться смещенными от центра.
- **Согласованность соотношения** — один слот пользовательского интерфейса не должен производить разный визуальный вес для каждого бренда.
- **Путь интеграции** — веб-приложениям нужен процесс, который работает без принуждения сервера в цикл.

## Где ClearLogo имеет свою позицию

ClearLogo расставляет приоритеты удобного вывода и потока с открытым ключом, удобного для браузера, что делает его хорошим выбором для панелей инструментов, CRM, инструментов обогащения и внутренних поверхностей продуктов.

### Пример запроса

```
GET https://api.clearlogo.dev/logo/example.com?size=128&content=80
```

```html
<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, списки учетных записей, поверхности обогащения — соотношение сторон и обработка фона это отличительные черты.