Co to jest Swagger-ui i na czym polega jego użycie?Jak rozpocząć korzystanie z usługi swagger-ui
Czy są jakieś dobre zasoby, aby zacząć korzystać z usługi swagger-ui? Jakieś dobre samouczki, blogi czy książki?
Mam również vist http://swagger.io/, ale potrzebuję więcej informacji.
Proszę mnie poprowadzić. Dzięki w adv
Swagger UI to narzędzie, które pobiera pliki specyfikacji Swagger, przedstawia je wizualnie i umożliwia wykonywanie operacji.
Sam Swagger to specyfikacja do dokumentowania i opisywania interfejsów API REST. Specyfikację można znaleźć tutaj - https://github.com/swagger-api/swagger-spec/. Repozytorium zawiera samą specyfikację, schemat json, próbki i tak dalej. Główny plik README repozytorium wskazuje również na dodatkowe narzędzia, w tym biblioteki i frameworki do tworzenia specyfikacji.
Jeśli chodzi o tworzenie specyfikacji Swagger, można użyć jednej z ram i zintegrować ją z istniejącym kodem, aby automatycznie wygenerować taką dokumentację.
Jeśli nie masz istniejącej aplikacji lub chcesz ją udokumentować ręcznie, możesz użyć narzędzia Swagger-Editor lub wybranego edytora tekstu.
Dzięki webronowi możesz uzyskać jasny obraz o swaggerze –
Mam już działający interfejs API Swagger. Co jest potrzebne, aby interfejs użytkownika Swagger mógł wyświetlać dokumentację interfejsu API? Samo otwarcie './Dist/index.html' i przejście do mojego interfejsu API nie jest w stanie tego zrobić. Czy muszę obsługiwać 'swagger.json' ręcznie przez http? Czy mój interfejs API potrzebuje dodatkowego punktu końcowego, w którym po prostu obsługuje plik .json? Dzięki za wytłumaczenie. – atripes
Pytanie jest niejasne i brakuje w nim szczegółów. Sugeruję albo rozpoczęcie nowego pytania z pełnymi szczegółami tutaj, albo skorzystanie z naszej grupy google, która jest ściślej monitorowana. – Ron