Swagger to specjalne narzędzie, które automatycznie składa RESTful API dokument swojej aplikacji.

Jego zaleta polega na tym, że pozwala nie tylko przejrzeć wszystkie punkty końcowe aplikacji, ale także od razu przetestować je w działaniu, wysyłając żądanie i otrzymując odpowiedź.

Aby uzyskać dostęp Swaggernależy nacisnąć na Preview w opublikowanej aplikacji i kliknąć na nazwę żądanego planu wydawniczego (Deploy Plan).

swagger access

W nowo otwartym oknie zostanie wyświetlona lista dostępnych punktów końcowych i metod związanych z tymi punktami. Niektóre żądania są dostępne tylko dla określonych grup autoryzowanych użytkowników (zob. Middleware z Auth module dla każdego konkretnego żądania w sekcji Endpoints sekcji). A Bearer Token jest wymagany dla żądań, które są dozwolone tylko dla autoryzowanych użytkowników.

Możesz uzyskać dostęp do odpowiedniego punktu końcowego bezpośrednio w Swagger aby uzyskać ten token (Auth sekcja, POST /auth żądanie).

swagger authorize

Naciśnij Try it out i wpisz login i hasło, aby uzyskać token.

Wniosek zostanie wysłany na Execute. Jeśli przebiegło pomyślnie, zobaczysz token pole z Bearer token wartość.

Drugi sposób na uzyskanie tokena autoryzowanego użytkownika polega na tym, że token można znaleźć w ciele żądania wdrożonej aplikacji.

  1. Naciśnij F12 w przeglądarce internetowej, aby otworzyć narzędzie dewelopera.
  2. Wyślij dowolne żądanie w swojej wdrożonej aplikacji (na przykład, aby zaktualizować tabele). Użytkownik, który wysyła to żądanie musi być upoważniony do dostępu do tego punktu końcowego.
  3. Otwórz Network zakładkę i znajdź odpowiadające jej żądanie.
  4. Przejdź do Headers zakładkę i znajdź Request Headers sekcja. Bearer token zostanie przedstawiona pod Authorization.

bearer token

Podaj Bearer token do Swagger naciskając Authorize i wklejając wartość, którą skopiowałeś w poprzednim kroku.

Dla zapytań testowych wybierz żądaną grupę i metodę, którą chcesz wykonać. Naciśnij Try it out i wypełnij parametry wejściowe żądania. Kliknij Execute aby wykonać odpowiedź.

Najbardziej oczekiwana odpowiedź, jeśli żądanie jest poprawnie przetwarzane przez serwer, ma kod 200 i pokazuje, jak powinna wyglądać struktura odpowiedzi.

response 200

  • 401 - żądanie nie zostało zakończone pomyślnie, ponieważ brakuje wymaganego tokena autoryzacji lub jest on nieważny.

    response 401

  • 404 - żądanie zostało przetworzone pomyślnie, ale żądany zasób nie został znaleziony.

    response 404

  • 422 - do wejścia żądania zostały przekazane nieprawidłowe parametry.

    response 1200

  • 500 - błąd przetwarzania żądania przez serwer.

    response 500

Wywołaj niestandardowy błąd

W przypadku niestandardowych BP i powiązanych żądań można utworzyć niestandardowe kody błędów z opisami za pomocą Raise Error w edytorze BP. Przykład takiego procesu znajduje się poniżej:

example

W tym przypadku, jeśli żądanie do punktu końcowego związanego z powyższym BP nie powiedzie się, serwer wystawi błąd 418 zawierający tekst błędu podczas wykonywania polecenia. DB: Create Candidate block. Kod błędu w tym przykładzie może być dowolny, określony przez użytkownika.

Uwaga: kod odpowiedzi błędu HTTP 418 I'm a teapot client wskazuje, że serwer odmawia zaparzenia kawy, ponieważ jest, na stałe, czajnikiem. Połączony dzbanek do kawy/herbaty, w którym chwilowo zabrakło kawy, powinien zamiast tego zwrócić 503. Ten błąd jest odniesieniem do Hyper Text Coffee Pot Control Protocol zdefiniowanego w żartach prima aprilisowych w 1998 i 2014 roku.

Was this article helpful?

AppMaster.io 101 Kurs zderzeniowy

10 moduły
2 Tygodnie

Nie wiesz, od czego zacząć? Rozpocznij z naszym szybkim kursem dla początkujących i poznaj AppMaster od A do Z.

Rozpocznij kurs
Development it’s so easy with AppMaster!

Potrzebujesz więcej pomocy?

Rozwiąż każdy problem z pomocą naszych ekspertów. Oszczędzaj czas i skup się na tworzeniu aplikacji.

headphones

Skontaktuj się z pomocą techniczną

Opowiedz nam o swoim problemie, a my znajdziemy dla Ciebie rozwiązanie.

message

Czat społeczności

Omów pytania z innymi użytkownikami na naszym czacie.

Dołącz do społeczności