Swagger - po co?

0

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?

0
szydlak napisał(a):

https://swagger.io/docs/specification/2-0/what-is-swagger/

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?

1

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.

0
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?

1
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

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