Skip to main content

Требования

Node.js

≥ 18.0.0

TypeScript

≥ 5.7 (опционально, типы включены)

React

≥ 17 (только для miniapp/react)

Установка через npm

React — опциональная peer-зависимость. Если проект не использует React, модуль miniapp/react не подтянет его и не попадёт в бандл.

Импорты

У пакета четыре subpath-экспорта — импортируйте только нужный:
@exode-team/sdk/api и @exode-team/sdk/miniapp/server предназначены только для сервера: первый работает с API-токеном школы, второй — с секретом страницы и использует модуль crypto из Node.js. Не импортируйте их в клиентский бандл.
Не импортируйте из корня (@exode-team/sdk) — корневой экспорт не определён, чтобы избежать случайной загрузки серверного и клиентского кода в одном бандле.

Подключение через CDN

Для статических страниц без сборки доступен IIFE-бандл MiniApp-модуля (ExodeMiniApp, retrieveInitData). React-хуки и серверные функции через CDN не поставляются.
После подключения глобальный объект ExodeMiniAppSDK становится доступен:
В продакшене всегда фиксируйте версию (v0.3.0, v0.3.1 и т. д.). Тег latest обновляется автоматически и может внести ломающие изменения. retrieveInitData есть в CDN-бандле начиная с v0.3.1. Номера версий на CDN могут отставать от npm — если нужной версии нет на CDN, используйте установку через npm.

TypeScript

Типы поставляются вместе с пакетом, дополнительный @types/... не требуется.

Обновлено: 2026-09-25 13:43 UTC