zerobig / swagger-1c

Документация HTTP сервисов в 1С при помощи swagger
MIT License
61 stars 10 forks source link

Попробовать переделать API в функциональном стиле #7

Closed zerobig closed 1 week ago

zerobig commented 1 week ago

Сейчас функции и процедуры API имеют достаточно большое количество параметров. Многие параметры пропускаются, устанавливаясь значениями по-умолчанию. Что вызывает путаницу.

Есть предложение переработать API в стиле:

ТестовыйОбъект = Swag_Описание.Объект()
    .Свойство("name")
        .Тип("string")
        .Пример("Лист дерева")
    .Свойство("children")
        .Тип("array")
        .ТипЭлементов("TestObject2");

На первый взгляд выглядит понятнее

zerobig commented 1 week ago

https://github.com/zerobig/swagger-1c/releases/tag/1.2.0