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
- Страница Gitsell: https://gitsell.ru/zerobig/swagger-1c