Модель API
API v1 — набор публичных статических JSON-файлов в UTF-8. Данные меняются только при публикации новой сборки. Реализован GET; поддержка HEAD определяется веб-сервером. Авторизации, API-ключей и серверных операций нет.
Все поля path, main, manifest, archive и packagePath относятся к корню установки, а не к расположению текущего JSON. Преобразуйте их через new URL(path, BASE).
Endpoints
| GET | Назначение |
|---|---|
| /v1/health.json | Идентификатор статической сборки и проверка доступности файла. |
| /v1/libraries.json | Полный каталог с версиями, путями, размерами и хешами. |
| /v1/packages.json | Метаданные пакетов и ссылки на ZIP-архивы. |
| /v1/integrity.json | SHA-384, SHA-256 и размер всех артефактов. |
| /v1/nodes.json | Иллюстративные узлы. Не телеметрия реальной сети. |
| /v1/manifest.json | Возможности и ограничения статического API. |
| /v1/libraries/dom-kit.json | Метаданные одной библиотеки. |
| /v1/libraries/dom-kit/1.1.0.json | Состав одной закреплённой версии. |
Шаблоны для всех библиотек: /v1/libraries/ИМЯ.json и /v1/libraries/ИМЯ/ВЕРСИЯ.json. Это готовые файлы, а не динамические маршруты.
Пример клиента
Поля ответа библиотеки
| Поле | Тип | Смысл |
|---|---|---|
id | string | Идентификатор каталога. |
defaultVersion | string | Основная версия в текущей сборке. |
versions | array | Опубликованные версии и артефакты. |
files[].size | number | Размер несжатого файла в байтах. |
files[].integrity | string | Готовый sha384-… для SRI. |
files[].sha256 | string | SHA-256 в шестнадцатеричной записи. |
Ошибки и ограничения
Несуществующий файл обычно возвращает 404, но код, тело и MIME ошибки определяет хостинг. Не предполагается единый JSON-формат ошибок. Проверяйте response.ok и Content-Type. Если хостинг перенаправляет все неизвестные URL в index.html, отключите такое правило для этого каталога.
Параметры ?q=, ?limit= и ?version= не обрабатываются приложением. Фильтруйте полученный массив в клиенте. POST, DELETE, purge, приватные пакеты и статистика трафика отсутствуют.
OpenAPI
Спецификация OpenAPI 3.0.3 описывает доступные JSON-документы. servers.url задан относительно самой спецификации, поэтому учитывает подпапку установки.