Narzędzie Listonosz: uproszczenie i zmiana kształtu testowania interfejsu API

Obecnie API (interfejsy programowania aplikacji) są w całym Internecie i odgrywają znaczącą rolę w naszej gospodarce. Jako użytkownik końcowy codziennie korzystamy z API, nawet nie zdając sobie z tego sprawy. Od rezerwacji biletu lotniczego po sprawdzenie prognozy pogody. Od możliwości logowania się na konta Google lub w mediach społecznościowych z dowolnej witryny internetowej po możliwość wyboru ulubionej usługi płatniczej w sklepie eCommerce. Otaczają nas API, a to tylko tworzy lepszy świat.

Chociaż interfejsy API ułatwiają nam życie, programiści napotykają wiele przeszkód, jeśli chodzi o testowanie ich przed użyciem ich na danych w czasie rzeczywistym. I wtedy wprowadzono narzędzie Postman. Narzędzie Postman podbiło świat API od samego początku i jest używane przez ponad 7 milionów programistów na całym świecie każdego miesiąca! W tym artykule omówimy więcej o narzędziu Postman, testowaniu interfejsów API za pomocą Postmana, automatyzacji testów i nie tylko. Bądźcie na bieżąco.

Tworzenie i testowanie interfejsów API

Chociaż istnieje wiele sposobów tworzenia interfejsu API, internetowy interfejs API jest zwykle tworzony przy użyciu struktury REST (Representational State Transfer). Framework REST określa zestaw wytycznych, których należy przestrzegać podczas tworzenia API. Ponieważ głównym motywem tworzenia API jest umożliwienie innym aplikacjom korzystania z usług, każdy etap procesu rozwoju API wymaga testowania funkcjonalności, obsługi wyjątków i bezpieczeństwa. Dlatego przestrzeganie pewnych wskazówek dotyczących projektowania interfejsu API od początku tworzenia interfejsu API jest kluczem do zminimalizowania problemów.

Ułatw testowanie dzięki narzędziu Postman

Co to jest narzędzie Listonosz? Jak to działa?

Narzędzie Postman to coś więcej niż tylko testowanie interfejsów API. Na pierwszy rzut oka wygląda jak interfejs do wysyłania żądań HTTP i przeglądania odpowiedzi. Ale w głębi duszy Postman opiera się na obszernym zestawie potężnych narzędzi, które są bardzo łatwe w użyciu. Narzędzie Postman umożliwia organizowanie żądań API w kolekcje i foldery, które mają wspólne wartości we wszystkich żądaniach ze zmiennymi środowiskowymi, testy skryptów za pomocą wbudowanego środowiska uruchomieniowego opartego na node.js i automatyzację ich za pomocą Newman. Będziemy mówić więcej o Newmanie, programie do uruchamiania kolekcji z wiersza poleceń dla Postmana.

Narzędzie do testowania Postman to kompletna platforma programistyczna API z różnymi wbudowanymi narzędziami, które wspierają każdy etap cyklu życia API. Narzędzie Postman umożliwia projektowanie, mock, debugowanie, automatyczne testowanie, dokumentowanie, monitorowanie i publikowanie interfejsów API – wszystko z jednego miejsca. Dostęp do Postmana można uzyskać za pośrednictwem natywnych aplikacji dla systemów MacOS, Linux i Windows.

Kompletna platforma programistyczna API Postmana pozwoli Ci tworzyć żądania, budować i zarządzać kolekcjami oraz zarządzać całym cyklem życia Twoich API.

Ewolucja narzędzia Listonosz

Narzędzie Postman zaczęło działać jako aplikacja Postman Chrome, kiedy po raz pierwszy się pojawiło, używane wraz z rozszerzeniem Postman Interceptor Chrome. Rozszerzenie Google Postman było powszechnie akceptowane i było jednym z najbardziej poszukiwanych narzędzi do testowania. Z biegiem lat ekosystem API ewoluował, dzięki czemu możliwości natywnych aplikacji Postman zostały ulepszone, aby przewyższyć wydajność rozszerzenia Postman chrome.

Jeśli jednak nadal korzystasz z aplikacji Postman Google Chrome, na górze może pojawić się baner z napisem „Aplikacje Chrome są wycofywane. Pobierz nasze bezpłatne aplikacje natywne, aby uzyskać dalsze wsparcie i lepszą wydajność”.

To się stało, gdy Google ogłosił swoje niezbyt świetne plany zakończenia obsługi aplikacji Chrome dla użytkowników systemów Windows, Mac i Linux. W odpowiedzi na deprecjację rozszerzenia Postman Google Chrome wprowadzili natywne aplikacje dla użytkowników systemów Windows, Mac i Linux oraz zachęcili ich do rozpoczęcia migracji. Nowe natywne aplikacje Postman obejmowały wszystkie funkcje i funkcje rozszerzenia Postman chrome, a w wielu przypadkach natywna aplikacja była nawet lepsza niż oryginalna aplikacja Chrome.

Ponieważ natywna aplikacja Postman działa lepiej niż aplikacja Postman Chrome, a proces migracji jest łatwy (zajmuje mniej niż minutę!), nadszedł czas, aby pożegnać się z rozszerzeniem Postman i przełączyć się na ich natywne aplikacje.

Instalacja aplikacji Postman również jest prosta. W zależności od systemu operacyjnego musisz pobrać aplikację listonosz ze strony https://www.getpostman.com/apps i postępować zgodnie z instrukcjami instalacji. Po zainstalowaniu aplikacja listonosza jest gotowa do przyjmowania żądań HTTP i testowania interfejsów API za pomocą listonosza.

Dlaczego listonosz?

Zestawy testowe — twórz je z łatwością

Aby upewnić się, że Twoje API działa zgodnie z oczekiwaniami, narzędzie Postman umożliwia tworzenie kolekcji testów integracyjnych. Dla każdego z tych testów, które są wykonywane w określonej kolejności, wykonywane jest żądanie HTTP, a asercje napisane w JavaScript służą do weryfikacji integralności kodu. Masz również swobodę manipulowania danymi, które otrzymujesz za pomocą aplikacji Postman, dzięki zapewnieniom napisanym w JavaScript.

Testujesz w różnych środowiskach? Bez problemu!

Jak często stwierdzasz, że ponieważ twoje lokalne środowisko jest skonfigurowane nieco inaczej niż serwer testowy, twoja kolekcja testów, która działa idealnie w twoim lokalnym środowisku, napotyka problem, gdy uruchamiasz ją w innym. Narzędzie do testowania Postman umożliwia przechowywanie pewnych informacji o różnych używanych środowiskach i automatyczne wstawianie poprawnej konfiguracji środowiska dla uruchomionej kolekcji testów.

Przechowywanie danych

Możesz mieć API, które wymaga pewnych konkretnych danych otrzymanych z innego API. Narzędzie Postman pozwala na przechowywanie takich danych z poprzednich testów w zmiennych globalnych, a te mogą być używane w podobny sposób jak zmienne środowiskowe. Możesz przechowywać odpowiedź lub część odpowiedzi i używać jej do kolejnych wywołań interfejsu API.

Lepsza integracja

Narzędzie do testowania Postman ma unikalny interfejs, który umożliwia łatwe uruchamianie kolekcji testów bezpośrednio z wiersza poleceń. Newman, który jest własnym interfejsem wiersza poleceń (CLI) Postmana, umożliwia uruchamianie tych testów na systemach, które nie mają GUI. Ponadto Newman daje możliwość uruchomienia kolekcji tych testów bezpośrednio z większości narzędzi do kompilacji.

Newman — ciągła integracja z narzędziem Postman Tool

Newman to w zasadzie narzędzie interfejsu wiersza poleceń, które pozwala uruchamiać kolekcje Postmana bezpośrednio z wiersza poleceń. Ich oficjalna strona internetowa opisuje Newmana jako: „Newman to program do uruchamiania kolekcji w wierszu poleceń dla Postmana. Newman umożliwia uruchamianie kolekcji w taki sam sposób, w jaki są one wykonywane w programie do uruchamiania kolekcji Postmana”. Ponieważ wszyscy wiemy, że ciągła integracja pomaga nam łączyć różne kody i wykonywać różne testy w sposób ciągły. Takie połączenie testów i kodu jest zazwyczaj sukcesem dzięki ciągłej integracji, którą w Postmanie zajmuje się Newman.

Newman jest zbudowany z myślą o łatwej integracji z Twoimi systemami kompilacji i serwerem ciągłej integracji. Pozwala programistom uzyskać szybką informację zwrotną na temat wydajności interfejsów API po zmianach w ich kodzie. Z pomocą Newmana integruje się z CI, a następnie, jeśli jakiekolwiek zmiany zostaną wprowadzone, CI uruchomi kolekcje listonosza z Newmanem.