swagger 1c

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

• GitHub: https://github.com/zerobig/swagger-1c
• Gitsell page: https://gitsell.ru/zerobig/swagger-1c
• Visibility: public/free
• GitHub stars: 117
• Gitsell views: 75
• Gitsell downloads: 0

1C Configurations

Not specified.

Pricing

Free or price is not specified.

README

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

Данный продукт предназначен для организации процесса документирования HTTP сервисов конфигураций написанных на платформе 1С:Предприятие.

Кроме swagger-ui для визуализации API могут использоваться следующие решения:

ReDoc

Scalar

Stoplight

RapiDoc

Для того чтобы переключиться на желаемую библиотеку в строке запроса надо добавить параметр:

/swagger/index.html?ui=scalar

Состав репозитория

• swagger - расширение конфигурации реализующее функциональность создания документации
• swagger-test - расширение для тестирования

Порядок установки

В режиме конфигуратора создать расширение и выполнить загрузку конфигурации из файлов, указав при этом каталог swagger.

Документация

Документация находится по адресу https://zerobig.github.io/swagger-1c/. Наполнение продолжается.

Запуск

Опубликовать базу 1С:Предприятия на web-сервере. Обязательно проконтролировать, что cтоит настройка публикации "Публиковать HTTP сервисы расширений по умолчанию". Возможно после публикации или изменения настроек публикации потребуется перезапуск web-сервера. Открыть в браузере страницу http://<Адрес_опубликованной_базы_1С_Предприятия>/hs/swagger/index.html

Создание описаний для своих HTTP сервисов

Поиск описаний происходит среди общих модулей. Наименование общего модуля должно быть построено по шаблону: "<Наименование_HTTP_сервиса>Описание".

Пример создания описания можно посмотреть:

• swagger-test\CommonModules\SwagTest_Тестовый_HTTPСервисОписание
• swagger-test\CommonModules\ПередачаДанныхОписание

Проверка входящих (запросов) и исходящих (ответов)

Реализовано через вызов обёрток "ПроверитьПараметры" и "ПроверитьОтвет" соответственно.

Для проверки входящих параметров:

РезультатПроверкиПараметров = Swag_ОбработкаHTTP.ПроверитьПараметры("SwagTest_Тестовый_HTTPСервис", "ТестовыйGET", Запрос);
Если Не ПустаяСтрока(РезультатПроверкиПараметров) Тогда
    Возврат Swag_ОбработкаHTTP.ПолучитьОтветОшибки(РезультатПроверкиПараметров, Истина);
КонецЕсли;

Для проверки ответа:

Возврат Swag_ОбработкаHTTP.ПроверитьОтвет("SwagTest_Тестовый_HTTPСервис", "ТестовыйGET", Ответ);