# Swagger для 1С:Предприятия 8

> Swagger для 1С:Предприятия 8 - инструмент для документирования HTTP сервисов конфигураций на платформе 1С. Визуализация через swagger-ui, ReDoc, Scalar, Stoplight, RapiDoc.

- Category: new-repos
- Published: 2025-08-27T05:22:13.478970
- Canonical: https://gitsell.ru/blog/swagger-dlya-1s-predpriyatiya-8

## Article


Репозиторий swagger-1c предоставляет расширение для платформы 1С:Предприятие 8, предназначенное для документирования HTTP-сервисов. Инструмент генерирует спецификацию OpenAPI на основе описаний в общих модулях конфигурации и визуализирует её через swagger-ui, ReDoc, Scalar, Stoplight или RapiDoc. Для переключения между библиотеками используется параметр в URL, например, `/swagger/index.html?ui=scalar`.

Установка выполняется в режиме конфигуратора: создайте расширение и загрузите файлы из каталога swagger. После публикации базы на веб-сервере с включенной опцией "Публиковать HTTP сервисы расширений по умолчанию" документация доступна по адресу `/hs/swagger/index.html`. Описания сервисов размещаются в общих модулях по шаблону "<Наименование_HTTP_сервиса>Описание". Инструмент поддерживает проверку входящих параметров и ответов через функции `ПроверитьПараметры` и `ПроверитьОтвет`.

- Поддержка нескольких библиотек визуализации для удобного просмотра API.
- Встроенная проверка запросов и ответов на соответствие спецификации.
- Простая интеграция как расширения конфигурации без изменения основной базы.
- Автоматическая генерация документации из общих модулей.
- Динамический доступ к спецификации без статических файлов (статический JSON в разработке).

## Ссылки
- GitHub: [zerobig/swagger-1c](https://github.com/zerobig/swagger-1c)
- Страница Gitsell: [https://gitsell.ru/zerobig/swagger-1c](https://gitsell.ru/zerobig/swagger-1c)