Замена Swagger UI
От: dmitry_npi Россия  
Дата: 14.12.23 06:11
Оценка:
У нас используется Swagger (Swashbuckle) для создания документации по АПИ и для вызова когда-никогда.
Но вот стандартный Swagger UI меня бесит:

— никак нельзя сгруппировать ендпойнты в иерархию с несколькими уровнями
— нет возможности "закрепить" часто используемые ендпойнты
— сбивающий с толку UI внутри endpoint (не поймешь, где результат вызова, а где возможные результаты
— необходимость писать какие-то фильтры для кастомизации (не хочется даже влезать в это)

Есть ли какие-то удобные альтернативы, такие чтобы ты просто пишешь комментарии и атрибуты в коде — а на выходе удобный интерактивный сайт, с настройкой в виде "опция вкл/опция выкл"?
Атмосферная музыка — www.aventuel.net
Re: Замена Swagger UI
От: Разраб  
Дата: 14.12.23 06:26
Оценка: 20 (2)
Здравствуйте, dmitry_npi, Вы писали:

_>У нас используется Swagger (Swashbuckle) для создания документации по АПИ и для вызова когда-никогда.

_>Но вот стандартный Swagger UI меня бесит:

_>- никак нельзя сгруппировать ендпойнты в иерархию с несколькими уровнями

_>- нет возможности "закрепить" часто используемые ендпойнты
_>- сбивающий с толку UI внутри endpoint (не поймешь, где результат вызова, а где возможные результаты
_>- необходимость писать какие-то фильтры для кастомизации (не хочется даже влезать в это)

_>Есть ли какие-то удобные альтернативы, такие чтобы ты просто пишешь комментарии и атрибуты в коде — а на выходе удобный интерактивный сайт, с настройкой в виде "опция вкл/опция выкл"?


https://openapi.tools/#documentation
☭ ✊ В мире нет ничего, кроме движущейся материи.
 
Подождите ...
Wait...
Пока на собственное сообщение не было ответов, его можно удалить.