Сейчас пытаюсь поднять сваггер для 1С. На эту тему находится только одна статья:
https://infostart.ru/1c/articles/1136245/
На этом форуме данная тема уже поднималась. По этой инструкции делали и ничего не получалось. У меня та же проблема. Очевидно, что автор статьи рассмотрел только один работающий кейс и не сосредотачивался на деталях.
На пункте "Настройка Simple-UI" не описано откуда брать путь. Я уже не говорю о том, что автор статью не потрудился объяснить как в IIS это все создавать. У скаченного исходника отсутствует каталог simple-ui\rest-admin.
Я предположил, что его нужно создать пустой. Добавил приложение, виртуальный каталог. Ничего не выходит, ошибка 500.
Дал админу почитать статью, он тоже ничего не понял. Следовательно, статья нуждается в доработке

А при чем тут миста?

Потому что именно на мисте вместо того, чтобы подсказать, как запустить сваггер, отсылают к этой статье

(2) Вот негодяи

https://github.com/botokash/swagger/commit/32c2780dcc6f9ee3ccc140074de61ec344da5c14
botokash committed on Oct 18, 2019
обновил spec-admin

simple-ui/rest-admin/list.os → simple-ui/spec-admin/list.os
File renamed without changes.

spec-admin это и есть rest-admin, в ходе разработки был переименован, а вот описание не исправили.

(2) :) капиталисты тоже плачут

"не дополняя общение постыдными фразами вида "ой, у нас 1С, у нас нет Swagger, наш программист сейчас напишет все в Ворде""
автор статьи стыдится тем, что он 1с-ник?

(6) Автор статьи стыдится того, что позиционирующая себя как "системообразующая" IT-компания 1С не может/не хочет реализовывать базовые для других стеков вещи

(7) пора понять, что никто никому ничем не обязан
но - человеку не нужен сыр, человек хочет быть правым (с)

(4) Спасибо. Но это не решает проблему. Наверно, файлы в этой папке как-то настраивать надо?

Реализуя что-то,что не является встроенным в 1с нужно сначала задаться вопросом,а где гарантии,что все будет работать в строгом следовании стандарту.
Например,для web-сервисов можно просто отдавать wsdl.
Что касается http-сервисов,то тут основная проблема,что в большинстве случаев,реализация разбора параметров делается в коде,и потом прекрасно оказывается,что параметр,который в документации описан как int,может принимать значение default или undefined.

(10) 👍 Вам лайк за ответ. Всё верно мыслите, но про стандарт ошиблись. Нет никакого стандарта, зато есть риски.

(10) Вот для таких и делают общие стандарты не зависящие от среды исполнения (типа 1С).
Если написано GET /store/order/{orderId} и orderId (required) - integer($int64) это то что должно быть.

(12) Вы забавны... Кем написаны? Кто должен? Что потерпит за невыполнение? А может ему похуй?

А то что для 1С получая файл UserAPI.json вы не можете указать parameters:        
name    "orderId"
in    "path"
description    "ID of pet that needs to be fetched"
required    true
type    "integer"
maximum    10
minimum    1
format    "int64", потому что внутри 1С нет ограничения на типы параметров, приходится самим делать как-то...

(13) Так если нет такого описания, то небольшое изменение формата может самым губительным образом сказаться на работе. Сам был свидетелем работы гос. контор по принципу примерного описания сервиса по приему данных которые Вы нам должны присылать. Вчера работало, сегодня сломалось... Что добавили или что-то по другому стало работать.

(0) А то что статья не дописана, считаю даже хорошо. Человеку придется разбираться как 1С script работает с файлами выгрузки конфигурации 1С, как из этих файлов библиотека onescript делает swagger json формат.

(16) и что хорошего? Сначала недоделанные отчеты, потом недоделанные дети

(17) Глубоко копает...
https://youtu.be/AHT9OMMXH5c

главный вопрос "зачем?" уже задавали?