Для AI-агентов: markdown этой страницы — /docs-content/infra/app-icon.md индекс документации — /llms.txt

Иконка приложения

Иконка приложения — это SVG, который показывается в каталоге приложений Bitrix24 и как фавикон во вкладке браузера. Платформа иконку не генерирует — вы загружаете свою через Deploy API. Эта страница — единый источник по формату и порядку загрузки; промпт «Иконка приложения» в кабинете ссылается сюда.

Скоуп: vibe:infra (добавляется в каждый API-ключ автоматически) · Базовый URL: https://vibecode.bitrix24.tech/v1 · Авторизация: заголовок X-Api-Key

Формат

  • Только SVG (image/svg+xml). Другие форматы отклоняются.
  • До 256 КБ.
  • Без скриптов, обработчиков событий и внешних ссылок — никаких <script>, on*-атрибутов, <foreignObject>, ссылок на внешние ресурсы. Иконка санитизируется при загрузке; небезопасное содержимое — причина отказа.
  • Загружаете SVG, отдаётся PNG. Загрузка принимает только SVG — он хранится как исходник. По URL отдачи иконка всегда возвращается как PNG 256×256 (Content-Type: image/png), сконвертированный платформой из вашего SVG. Если SVG не удаётся растеризовать, загрузка отклоняется с ошибкой ICON_RASTERIZE_FAILED — переделайте файл и загрузите заново.

Загрузка иконки — обязательный шаг (без исходников)

Сгенерируйте SVG и загрузите его на сервер:

POST /v1/infra/servers/:id/icon
Content-Type: multipart/form-data — поле file, тип image/svg+xml

Это единственный обязательный шаг, и он не требует исходников приложения: иконка сразу появляется в каталоге приложений Bitrix24 и доступна по стабильному анонимному URL отдачи …/api/server-icons/:id. Перезаливка/перегенерация позже — повторный тот же POST.

Фавикон во вкладке — одна строка в HTML

Чтобы иконка стала ещё и фавиконом во вкладке браузера, добавьте в HTML приложения одну строку:

html 
<link rel="icon" href="/_gw/icon">

/_gw/icon — платформенный путь на том же домене приложения (его обслуживает платформа, а не ваше приложение), который всегда отдаёт текущую загруженную иконку. Строка не содержит id сервера и одинакова для всех приложений — её можно вписать при сборке в один заход (в том числе при создании приложения одним запросом).

Свой статический файл иконки (/icon.svg и подобные) в приложение класть не нужно — статический файл нельзя поменять через интерфейс платформы Вайбкод. /_gw/icon же обновляется сам: перезалили иконку через POST …/icon — фавикон обновится в течение ~5 минут, пересобирать приложение не надо.

Смена иконки — без пересборки

Иконка каталога и фавикон во вкладке — одно и то же изображение, и обе управляются одной загрузкой:

  • Загрузите новый SVG тем же POST …/icon — обновятся и карточка в каталоге Bitrix24, и фавикон во вкладке (/_gw/icon, в течение ~5 минут).
  • Исходники приложения для этого не нужны; пересобирать и передеплоивать не надо — при условии, что строка <link rel="icon" href="/_gw/icon"> была вписана при сборке.
  • Если строку <link> не добавляли — фавикона во вкладке не будет (это ожидаемо), но иконка в каталоге работает. Добавить фавикон можно при следующей пересборке, вписав строку <link> (id при этом не нужен).

Смотрите также