@gitdev

Есть ли инструмент для автоматической генерации Swagger(Open API) документации?

Нужно создать полноценную документацию к АПИ моего проекта. Пытаюсь понять как это лучше выполнить чтоб можно было запустить на нашем сервере и получать дотуп к Swagger(Open API).

Идея: создать страницу на которую можно будет зайти и нажать "Try out" и проверить как выполняется запрос. Результат хотел бы получить примерно как на скриншоте:
60f7267f40a58390148769.png

А так же интересует Generate Server подойдет ли для генерации клиент или сервера с данными?
60f7270d780fb522596427.png
  • Вопрос задан
  • 24 просмотра
Пригласить эксперта
Ответы на вопрос 1
DevMan
@DevMan
а как связаны "полноценная документация" и "Try out"?
документация – это одно. песочница для кода – совершенно другое. хотя иногда их и удобно/полезно совместить.

лично я считаю что вполне достаточно актуальных и рабочих примеров в тексте (документации), а сам код человек может запустить и сам, со своего хоста.без всякой вашей песочницы.
Ответ написан
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Войти через центр авторизации
Похожие вопросы