Мобильное приложение
REST API
Тестирование

Правила сборки

Разместить можно только веб-приложение: страницу из HTML, CSS и JavaScript, которая открывается в браузере. Серверное приложение на PHP или Node и сборка мобильного приложения сюда не подходят.

Подойдёт страница без фреймворка или сборка на Vue, React, Angular или Svelte. Собрать её можно Vite или Webpack. Готовые HTML, CSS и JS можно упаковать в zip и без сборщика.

В корне архива должен лежать index.html. Если в архиве одна папка и index.html лежит в ней, сервис поднимет содержимое этой папки в корень. Каталог __MACOSX не мешает.

Пути к скриптам и стилям должны быть относительными: ./assets/index.js, а не /assets/index.js. Для Vite это настройка base: "./". При открытии сервис подставляет base на каталог именно этой версии, и относительные файлы берутся оттуда.

Архив


  • размер архива — не больше 64 МБ
  • размер после распаковки — не больше 200 МБ
  • файлов — не больше 5000

Архив не примут, если внутри есть скрытые файлы и каталоги, символические ссылки, пути с .., файлы php и других серверных расширений, а также .htaccess, .htpasswd, web.config и .user.ini.

Мост


Скрипт моста в сборку класть не нужно. Сервис сам добавляет его в index.html. Если страница уже подключает sbs-bridge.js, второй скрипт не добавляется.

После загрузки доступен window.sbsBridge. Через него страница просит СБС выполнить метод от имени того, кто её открыл:

const profile = await sbsBridge.rest.call("user.profile.get");

Несколько методов уходят одним пакетом. Ключи объекта — имена ответов, внутри тот же формат, что у rest.batch:

const result = await sbsBridge.rest.batch({
  profile: {
    ENTITY: "user",
    METHOD: "profile.get",
    PARAMS: {}
  },
  stats: {
    ENTITY: "request",
    METHOD: "statistics",
    PARAMS: {
      select: { 0: "type_id", 1: "cnt", type_name: "type.name" },
      filter: {
        ">=date_create": "01.08.2026",
        "<date_create": "03.11.2026"
      },
      group: ["type_id", "type.name"],
      order: { cnt: "desc" }
    }
  }
});

В ответе те же ключи: result.profile — ответ user.profile.get, result.stats — ответ request.statistics.

Свой токен авторизации в сборку класть не нужно. Если страница открыта не внутри СБС, вызов завершится ошибкой «Страница открыта вне СБС».

В адресе открытия рядом с ключом запуска может быть тема, например /webapp/15/?ticket=...&theme=dark. Страница читает её так:

const theme = new URLSearchParams(location.search).get("theme");
Ключ ticket нужен только чтобы открыть страницу. В код приложения его забирать не нужно.