Swagger - po co?

2018-12-15 09:59
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?

Pozostało 580 znaków

2018-12-15 10:33
2018-12-15 10:39
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?

Pozostało 580 znaków

2018-12-15 10:50
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.

edytowany 1x, ostatnio: szydlak, 2018-12-15 10:52

Pozostało 580 znaków

2018-12-15 10:52
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?

Pozostało 580 znaków

2018-12-15 10:56
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

edytowany 1x, ostatnio: szydlak, 2018-12-15 10:57
Ale rozumiem, że najpierw piszesz API, a później Swagger, czy może być na odwrót? - bakunet 2018-12-15 11:00
Swaggera nie piszesz tylko instalujesz i dodajesz attrybuty do Akcji kontrollera - szydlak 2018-12-15 11:01
Czyli w praktyce nie korzysta się z edytora online? - bakunet 2018-12-15 11:07
Może i się korzysta, ja ci napisałem tylko mój punkt widzenia. Bo akurat mam jeden projekt gdzie jest swagger ale ja robie backend i nie korzystam z niego jakoś specjalnie. Jak testuje to najczęściej postmanem. - szydlak 2018-12-15 11:11
Myślę, że Twój komentarz będzie dla mnie bardzo pomocny, wiem dokładniej czego szukać. Dzięki - bakunet 2018-12-15 11:33

Pozostało 580 znaków

Liczba odpowiedzi na stronę

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