Hej, zastanawiam się do czego służy Swagger. Jak się o nim dowiedziałem to wydawało mi się, że służy on do tworzenia API, ale na chwilę obecną to chyba on jedynie pomaga tworzyć dokumentację oraz interfejs, czy się mylę? I czy ten interfejs jest w ogóle przydatny komuś do czegoś? I czy to polega na podłączaniu jego kodu do URL API, na ten przykład http://localhost:7000/api/
, i ten interfejs Swaggerowy pomaga obsługiwać API? Bo nie do końca rozumiem funkcjonalność tego narzędzia. Jak on się ma do konsumera API?
szydlak napisał(a):
** Well, by reading your API’s structure, we can automatically build beautiful and interactive API documentation**
Ale po co? I co jest najpierw? API czy dokumentacja?
To pomyśl sobie, że jesteś frontendowcem i musisz w jakimś angularze to obsługiwać. To co będziesz zaglądał we wszystkie dto co jaki ma wyglądać ?. Swagger to ułatwia.
A jeśli chodzi o dokumentacja to wątpliwe raczej, że od początku masz takie szczegóły w dokumentacji jak pokazuje Ci swagger po zaimplementowaniu.
szydlak napisał(a):
To pomyśl sobie, że jesteś frontendowcem i musisz w jakimś angularze to obsługiwać. To co będziesz zaglądał we wszystkie dto co jaki ma wyglądać ?. Swagger to ułatwia
Ok, czyli dokumentacja. A po co jest UI? Do testowania?
bakunet napisał(a):
szydlak napisał(a):
To pomyśl sobie, że jesteś frontendowcem i musisz w jakimś angularze to obsługiwać. To co będziesz zaglądał we wszystkie dto co jaki ma wyglądać ?. Swagger to ułatwia
Ok, czyli dokumentacja. A po co jest UI? Do testowania?
No myślę, że tak. Robisz coś co korzysta z api (angular, mobile itp) to możesz sobie podejrzeć typ odpowiedzi, błędy itp. Zobacz, że tam są gotowe JSONY. W przypadku bardzo rozbudowanych DTO klepanie tego jest czasochłonne