Просмотреть исходный

Mini-Apps — это системный модуль, позволяющий пользователям добавлять, настраивать и запускать внешние веб-ресурсы (URL) внутри приложений Elph.

Подготовительные действия

Чтобы настроить Mini-Apps, добавьте роль miniapp-admin пользователю, от которого будет производиться настройка.

Для этого в Keycloak перейдите в меню «Users», выберите пользователя, перейдите во вкладку «Role Mapping», нажмите «Assign Role»:

Eltex Documentation > Mini-apps > image-2026-1-30_10-52-50.png

Укажите фильтр «Filter by realm roles», выберите «miniapp-admin» и нажмите «Assign».

Eltex Documentation > Mini-apps > image-2026-1-30_10-53-53.png

Просмотр добавленных Mini-Apps

Чтобы посмотреть список доступных приложений, отправьте GET {{proxy-url}}/elph/mini_apps/v1/mini-app-services/list с токеном пользователя с ролью miniapp-admin.

Пример ответа:

{
    {
        "id": "550e8400-e29b-41d4-a716-446655440002",
        "name": "Eltex",
        "iconUrl": "https://eltex-co.ru/images/logo.svg",
        "webUrl": "https://eltex-co.ru",
        "etag": "6d87debd7e9a245dda3245ef28439030",
        "createdAt": "2025-12-23T10:05:45.315Z",
        "updatedAt": "2025-12-23T10:05:45.315Z",
        "permissions": [],
        "userAllowlist": []
    },
}

Добавление Mini-Apps

Чтобы добавить приложение, отправьте POST {{proxy-url}}/elph/mini_apps/v1/mini-app-services с токеном пользователя с ролью miniapp-admin и телом:

{
  "id": "11111111-1111-4111-8111-111111111111",
  "name": "eltex-co",
  "iconUrl": "https://eltex-co.com/favicon_eltex.ico",
  "webUrl": "https://eltex-co.ru/"
}

Поле	Описание
id	Уникальный идентификатор, присваиваемый один раз при создании записи.
name	Отображаемое имя Mini-App.
iconURL	Ссылка на иконку Mini-App.
webUrl	Основная точка входа в приложение. Должна быть абсолютным URL (включая протокол http или https).

После успешного добавления в приложениях Elph во вкладке «Сервисы» появятся ваши Mini Apps:

Eltex Documentation > Mini-apps > image-2026-1-30_11-45-43.png

Изменение Mini-Apps

Для изменения Mini-Apps используется запрос PUT {{proxy-url}}/elph/mini_apps/v1/mini-app-services/{{miniapp_id}} с токеном пользователя с ролью miniapp-admin и телом:

{
  "name": "eltex-co",
  "iconUrl": "https://eltex-co.com/favicon_eltex.ico",
  "webUrl": "https://eltex-co.com/"
}

Удаление Mini-Apps

Для удаления Mini-App используется запрос DELETE {{proxy-url}}/elph/mini_apps/v1/mini-app-services/{{miniapp_id}} с токеном пользователя с ролью miniapp-admin.