Частые вопросы
Всё, что вы хотели знать о Favicon.is и фавиконах в целом.
Что такое Favicon.is?
Favicon.is — бесплатный и быстрый сервис, который возвращает фавикон (иконку сайта) любого сайта. Добавьте домен после https://favicon.is/ — и получите его иконку в виде изображения. Сервис создан для разработчиков, дизайнеров и всех, кому быстро нужны иконки сайтов.
Что такое фавикон?
Фавикон (от англ. «favorite icon» — «иконка избранного») — это маленькая иконка, которая обозначает сайт. Браузеры показывают её во вкладках, закладках, истории и адресной строке, а смартфоны используют для ярлыков на главном экране.
Как Favicon.is находит иконку?
Сначала мы ищем её в нашем edge-кэше и хранилище R2. Если иконка ещё не сохранена, мы запрашиваем кэш фавиконов Google, затем ищем объявления иконок в HTML сайта и, наконец, пробуем /favicon.ico. Лучший результат сохраняется и возвращается.
Почему бы просто не использовать example.com/favicon.ico?
Многие сайты не хранят иконку по адресу /favicon.ico, сам файл часто имеет размер всего 16 или 32 пикселя, а если его нет, никакой замены не предусмотрено — и вы получаете битые изображения.
Favicon.is проверяет несколько мест, выбирает лучший размер и всегда возвращает изображение.
Как получить иконку в высоком разрешении?
Добавьте ?larger=true, чтобы получить иконку 256 пикселей, или ?size= со значением 16, 32, 48, 64, 128 или 256 для конкретного размера. Учтите, что иконка не может быть чётче самой большой иконки, которую публикует сайт.
Что будет, если у сайта нет фавикона?
Вы получите нейтральную иконку по умолчанию со статусом HTTP 200, так что в вашем интерфейсе никогда не появится битое изображение. Заголовок ответа X-Source при этом имеет значение default, поэтому такой случай легко распознать в коде.
Какие домены поддерживаются?
Любой домен или поддомен, суффикс которого — домен верхнего уровня из базы корневой зоны IANA, включая национальные и интернационализированные TLD, например .中国 или .рф. Домены с другими суффиксами не обрабатываются.
В каких форматах возвращаются изображения?
Большинство иконок — в формате PNG. В зависимости от сайта вы также можете получить ICO, SVG, JPEG, GIF или WebP. Заголовок Content-Type всегда указывает формат.
Насколько актуальны иконки?
Сохранённые иконки обновляются в фоне через семь дней. Браузеры и CDN могут кэшировать каждый ответ на сутки.
Можно ли использовать Favicon.is в коммерческих проектах?
Да. Сервис бесплатен для личного и коммерческого использования. Помните, что логотипы принадлежат их владельцам, поэтому используйте их для обозначения сайтов, а не в качестве собственного брендинга.
Есть ли ограничение на количество запросов?
При обычном использовании эндпоинта изображений жёсткого лимита нет. Чтобы сервис оставался честным для всех, злоупотребляющий трафик может ограничиваться, а JSON API проверки допускает 30 запросов в минуту с одного IP. Свяжитесь с нами, прежде чем отправлять очень большие объёмы запросов.
Вы отслеживаете тех, кто просматривает иконки?
Нет. Мы не устанавливаем cookie при запросах иконок и не составляем профили. Подробнее о немногочисленных журналах, которые мы храним, читайте в политике конфиденциальности.