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

Иконка приложения — это 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 и загрузите его на сервер:

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

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

Фавикон во вкладке — разовая настройка при сборке

Чтобы иконка ещё и стала фавиконом во вкладке браузера, в HTML приложения должна быть строка <link> на тот же URL отдачи. Её нужно вписать во время сборки, до деплоя (после деплоя без пересборки не добавить):

html 
<link rel="icon" type="image/svg+xml" href="https://vibecode.bitrix24.tech/api/server-icons/<serverId>">

Подставьте id целевого сервера вместо <serverId>. URL стабильный: отдаёт 404, пока иконки нет, и резолвится после загрузки. Это разовая настройка — как только <link> есть в собранном HTML, любая последующая перезаливка иконки обновляет фавикон во вкладке сама (в течение ~5 минут; контент по URL ревалидируется), пересобирать приложение повторно не нужно.

Перегенерация без исходников

Если приложение уже задеплоено, а исходников под рукой нет (пересобрать HTML нельзя):

  • Сделайте только загрузку (POST …/icon) — каталог Bitrix24 обновится всегда, исходники не нужны.
  • Таб-фавикон обновится автоматически, если строка <link> была вписана при первом деплое (URL стабильный — см. выше).
  • Если <link> никогда не добавляли и пересобрать приложение нельзя — таб-фавикона не будет (это ожидаемо), но иконка в каталоге Bitrix24 работает. Добавить таб-фавикон можно при следующей пересборке/деплое, вписав строку <link>.

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