Dokumentowanie API w Django

0

Hej, ostatnio, trafiłem na małe problemy. Korzystam z DRF i chciałem udokumentować jakoś stworzone API, ale... generowanie schemy przy pomocy wbudowanego w DRF get_schema_view poległo przy moim układzie URLi (mam na ścieżce '' pusty string include(<urle mojej glownej aplikacji>), gdzie nie dodawało mi prowadzącego slasha, co tak jak można się spodziewać powodowało, że żaden z endpointów nie działał. (nie mam na chwilę obecną czasu tego debugować).

Drugi sposób - próbowałem użyć DRF_yasg, w którym jednak, żeby to sensownie skonfigurować mam wrażenie, że trzeba dużo overheadu, tzn. np: wyszczególnienie parametrów, i specjalne definiowanie odpowiedzi jak np.:

test_param = openapi.Parameter('test', openapi.IN_QUERY, description="test manual param", type=openapi.TYPE_BOOLEAN)
user_response = openapi.Response('response description', UserSerializer)

Są jeszcze jakieś inne sposoby, żeby nie dodawać aż prawie że drugiej "logiki" do istniejącego kodu, żeby udokumentować DRF API, korzystając bardziej z tego co się już napisało niż z customowego dokumentowania? Mam wrażenie, że trochę przekombinowany ten mechanizm, w drf_yasg, gdyby tym lecieć konkretnie to prawdopodobnie wyjdzie druga ilość kodu zaraz przy endpointach ktora będzie odpowiedzialna tylko za ich dokumentację.

0

Nie jestem webdeveloperem ale...
Z reguły projektujesz API (np. swagger) -> Implementuje API (Django DRF) | tj. tak chyba jest "prawilnie" ?
Nie bardzo rozumiem idee robienie tego na odwrot ?

Nie znam zadnego narzedzia niestety które by pomogło.

1 użytkowników online, w tym zalogowanych: 0, gości: 1