Szukam funkcji Swagger do udokumentowania mojego spokojnego interfejsu. Problem polega na tym, że nie chcę automatycznie generować mojej dokumentacji, dodając adnotację do mojego kodu. Zasadniczo nie chcę łączyć wewnętrznego modelu danych z wirtualnym modelem danych udostępnianym przez interfejs. Wygląda na to, że mogę po prostu udostępnić serwerowi plik Resources.json, a następnie odpowiedni plik JSON dla każdego programu obsługi zasobów. Jednak kiedy próbowałem tego dokonać, natknąłem się na wiele małych problemów podczas próby zdefiniowania poprawnej składni JSON i zapewnienia poprawnych pól odpowiedzi nagłówka HTTP.

Czy ktoś użył Swagger w ten sposób? Czy ktoś ma jakąś dokumentację lub przykłady? Wszystko, co mogłem znaleźć, to po prostu używanie bibliotek klienta do generowania rzeczy dla ciebie.