Postman Poradnik

๐Ÿš€ Inteligentne podsumowanie

Postman to skalowalne narzฤ™dzie do testowania API, zaprojektowane z myล›lฤ… o efektywnym zarzฤ…dzaniu przepล‚ywem pracy API w ล›rodowiskach programistycznych i testowych. Umoลผliwia usprawnionฤ… organizacjฤ™, wspรณล‚pracฤ™ i automatyzacjฤ™, dziฤ™ki czemu kluczowe zadania zwiฤ…zane z testowaniem API sฤ… dostฤ™pne i powtarzalne.

  • Zasada kluczowa: Postman zapewnia ujednoliconฤ… przestrzeล„ roboczฤ… do tworzenia, testowania i zarzฤ…dzania ลผฤ…daniami API, obsล‚ugujฤ…c zarรณwno rฤ™czne, jak i automatyczne przepล‚ywy pracy testowe.
  • Cel wdroลผenia: Organizuj proล›by w kolekcjach, ktรณre nastฤ™pnie moลผesz podzieliฤ‡ na foldery i ล‚atwo udostฤ™pniaฤ‡ czล‚onkom zespoล‚u, aby zapewniฤ‡ efektywnฤ… wspรณล‚pracฤ™.
  • Zasada parametryzacji: Uลผyj zmiennych ล›rodowiskowych i globalnych z podwรณjnymi nawiasami klamrowymi (np. {{url}}), aby sparametryzowaฤ‡ ลผฤ…dania, zmniejszajฤ…c redundancjฤ™ i umoลผliwiajฤ…c ponowne wykorzystanie w wielu punktach koล„cowych interfejsu API.
  • Podstawy testowania: Pisaฤ‡ JavaTesty oparte na skryptach na karcie Testy umoลผliwiajฤ… weryfikacjฤ™ kodรณw statusu, treล›ci odpowiedzi i oczekiwanych wartoล›ci, zapewniajฤ…c solidne pokrycie interfejsu API i niezawodnoล›ฤ‡.
  • ลšcieลผka automatyzacji: Kolekcje moลผna uruchamiaฤ‡ za pomocฤ… Collection Runner lub Newman. Ten drugi jest niezbฤ™dny do integracji CI/CD i zautomatyzowanego wykonywania wsadowego przy uลผyciu interfejsรณw wiersza poleceล„.

Postman Poradnik

Czym jest Postman?

Postman To skalowalne narzฤ™dzie do testowania API, ktรณre szybko integruje siฤ™ z procesem CI/CD. Powstaล‚o w 2012 roku jako projekt poboczny Abhinava Asthany, majฤ…cy na celu uproszczenie procesu testowania i rozwoju API. API to skrรณt od Application Programming Interface (interfejs programowania aplikacji), ktรณry umoลผliwia aplikacjom komunikacjฤ™ miฤ™dzy sobฤ… za pomocฤ… wywoล‚aล„ API.

๐Ÿ‘‰ Zapisz siฤ™ na bezpล‚atny projekt testowania interfejsu API na ลผywo

Dlaczego warto korzystaฤ‡ Postman?

Obecnie ma ponad 4 miliony uลผytkownikรณw, Postman Oprogramowanie staล‚o siฤ™ narzฤ™dziem pierwszego wyboru z nastฤ™pujฤ…cych powodรณw:

  1. Dostฤ™pnoล›ฤ‡ โ€“ Aby korzystaฤ‡ z Postman narzฤ™dzie, wystarczy zalogowaฤ‡ siฤ™ na swoje konto, co uล‚atwia dostฤ™p do plikรณw w dowolnym czasie i miejscu, pod warunkiem, ลผe Postman aplikacja jest zainstalowana na komputerze.
  2. Korzystanie ze zbiorรณw โ€“ Postman pozwala uลผytkownikom tworzyฤ‡ kolekcje dla swoich Postman Wywoล‚ania API. Kaลผda kolekcja moลผe tworzyฤ‡ podfoldery i wiele ลผฤ…daล„. Pomaga to w organizacji zestawรณw testowych.
  3. Wspรณล‚praca โ€“ Kolekcje i ล›rodowiska moลผna importowaฤ‡ i eksportowaฤ‡, co uล‚atwia udostฤ™pnianie plikรณw. Do udostฤ™pniania kolekcji moลผna rรณwnieลผ uลผyฤ‡ bezpoล›redniego ล‚ฤ…cza.
  4. Tworzenie ล›rodowisk โ€“ Posiadanie wielu ล›rodowisk pozwala ograniczyฤ‡ liczbฤ™ powtรณrzeล„ testรณw, poniewaลผ moลผna uลผywaฤ‡ tej samej kolekcji, ale w innym ล›rodowisku. To wล‚aล›nie tutaj nastฤ…pi parametryzacja, ktรณrฤ… omรณwimy w kolejnych lekcjach.
  5. Tworzenie testรณw โ€“ do kaลผdego testu moลผna dodaฤ‡ punkty kontrolne, takie jak weryfikacja statusu pomyล›lnej odpowiedzi HTTP. Postman Wywoล‚ania API, ktรณre pomagajฤ… zapewniฤ‡ pokrycie testu.
  6. Testowanie automatyczne โ€“ dziฤ™ki zastosowaniu Collection Runner lub Newman testy moลผna uruchamiaฤ‡ w wielu iteracjach, oszczฤ™dzajฤ…c czas na powtarzalne testy.
  7. Debugowanie - Postman Konsola pomaga sprawdziฤ‡, jakie dane zostaล‚y pobrane, dziฤ™ki czemu moลผna ล‚atwo debugowaฤ‡ testy.
  8. Ciฤ…gล‚a integracja โ€“ Dziฤ™ki zdolnoล›ci do wspierania ciฤ…gล‚ej integracji, praktyki rozwojowe sฤ… utrzymywane.

Jak uลผywaฤ‡ Postman do wykonywania interfejsรณw API

Poniลผej znajduje siฤ™ Postman Przestrzeล„ robocza. Przyjrzyjmy siฤ™ krok po kroku procesowi Jak uลผywaฤ‡ Postman i rรณลผne cechy Postman narzฤ™dzie!

Jak uลผywaฤ‡ Postman Aby wykonaฤ‡ interfejsy API

  1. Nowy โ€“ w tym miejscu utworzysz nowe ลผฤ…danie, kolekcjฤ™ lub ล›rodowisko.
  2. Import โ€“ sล‚uลผy do importowania kolekcji lub ล›rodowiska. Dostฤ™pne sฤ… takie opcje, jak import z pliku, folderu, linku lub wklejanie surowego tekstu.
  3. Runner โ€“ testy automatyczne moลผna wykonaฤ‡ poprzez Collection Runner. Zostanie to omรณwione szerzej w nastฤ™pnej lekcji.
  4. Otwรณrz nowฤ… โ€“ otwรณrz nowฤ… kartฤ™, Postman Okno lub Okno Runnera, klikajฤ…c ten przycisk.
  5. Mรณj obszar roboczy โ€” moลผesz utworzyฤ‡ nowy obszar roboczy indywidualnie lub w zespole.
  6. Zaproล› โ€” wspรณล‚pracuj w obszarze roboczym, zapraszajฤ…c czล‚onkรณw zespoล‚u.
  7. Historia โ€“ poprzednie proล›by, ktรณre wysล‚aล‚eล›, zostanฤ… wyล›wietlone w Historii. Uล‚atwia to ล›ledzenie wykonanych dziaล‚aล„.
  8. Kolekcje โ€“ Uporzฤ…dkuj swรณj zestaw testรณw, tworzฤ…c kolekcje. Kaลผda kolekcja moลผe mieฤ‡ podfoldery i wiele ลผฤ…daล„. ลปฤ…danie lub folder moลผna rรณwnieลผ duplikowaฤ‡.
  9. Karta Request โ€“ wyล›wietla tytuล‚ ลผฤ…dania, nad ktรณrym pracujesz. Domyล›lnie โ€žUntitled Requestโ€ bฤ™dzie wyล›wietlane dla ลผฤ…daล„ bez tytuล‚รณw.
  10. ลปฤ…danie HTTP โ€“ klikniฤ™cie tego spowoduje wyล›wietlenie listy rozwijanej zawierajฤ…cej rรณลผne ลผฤ…dania, takie jak GET, POST, COPY, DELETE itd. Postman Testowanie API, najczฤ™ล›ciej uลผywanymi ลผฤ…daniami sฤ… GET i POST.
  11. Adres URL ลผฤ…dania โ€“ znany rรณwnieลผ jako punkt koล„cowy. W tym miejscu naleลผy wskazaฤ‡ ล‚ฤ…cze, z ktรณrym bฤ™dzie komunikowaฤ‡ siฤ™ interfejs API.
  12. Zapisz โ€“ jeล›li w ลผฤ…daniu zaszล‚y zmiany, klikniฤ™cie przycisku Zapisz jest koniecznoล›ciฤ…, aby nowe zmiany nie zostaล‚y utracone ani nadpisane.
  13. Parametry โ€“ w tym miejscu naleลผy wpisaฤ‡ parametry potrzebne do ลผฤ…dania, takie jak wartoล›ci kluczowe.
  14. Autoryzacja โ€“ Aby uzyskaฤ‡ dostฤ™p do interfejsรณw API, potrzebna jest odpowiednia autoryzacja. Moลผe ona przybieraฤ‡ formฤ™ nazwy uลผytkownika i hasล‚a, tokena na okaziciela itp.
  15. Nagล‚รณwki โ€“ Moลผesz ustawiฤ‡ nagล‚รณwki, takie jak typ zawartoล›ci JSON, w zaleลผnoล›ci od potrzeb organizacji.
  16. Treล›ฤ‡ โ€“ w tym miejscu moลผna dostosowaฤ‡ szczegรณล‚y ลผฤ…dania, zwykle uลผywane w przypadku ลผฤ…dania POST.
  17. Skrypt przed ลผฤ…daniem โ€“ sฤ… to skrypty, ktรณre zostanฤ… wykonane przed ลผฤ…daniem. Zwykle uลผywane sฤ… skrypty wysyล‚ajฤ…ce ลผฤ…danie dla ล›rodowiska ustawieล„, aby zapewniฤ‡ uruchomienie testรณw w odpowiednim ล›rodowisku.
  18. Testy โ€“ to skrypty wykonywane podczas ลผฤ…dania. Testy sฤ… waลผne, poniewaลผ tworzฤ… punkty kontrolne weryfikujฤ…ce, czy status odpowiedzi jest prawidล‚owy, pobrane dane sฤ… zgodne z oczekiwaniami, oraz inne testy.

Praca z ลผฤ…daniami GET

ลปฤ…dania typu โ€žgetโ€ sล‚uลผฤ… do pobierania informacji z podanego adresu URL. W punkcie koล„cowym nie zostanฤ… wprowadzone ลผadne zmiany.

W przypadku wszystkich przykล‚adรณw w tym artykule bฤ™dziemy uลผywaฤ‡ nastฤ™pujฤ…cego adresu URL Postman Tutorial https://jsonplaceholder.typicode.com/users

W obszarze roboczym

  1. Ustaw ลผฤ…danie HTTP na GET.
  2. W polu adresu URL ลผฤ…dania wprowadลบ ล‚ฤ…cze
  3. Kliknij Wyล›lij
  4. Zobaczysz komunikat โ€ž200 OKโ€
  5. W treล›ci testu powinno znaleลบฤ‡ siฤ™ 10 wynikรณw uลผytkownika, co oznacza, ลผe โ€‹โ€‹test zostaล‚ przeprowadzony pomyล›lnie.

Praca z ลผฤ…daniami pobierania

*Uwaga: Mogฤ… wystฤ…piฤ‡ przypadki, w ktรณrych Get Postman ลปฤ…danie moลผe siฤ™ nie powieล›ฤ‡. Moลผe to byฤ‡ spowodowane nieprawidล‚owym adresem URL ลผฤ…dania lub koniecznoล›ciฤ… uwierzytelnienia.

Praca z ลผฤ…daniami POST

ลปฤ…dania typu POST rรณลผniฤ… siฤ™ od ลผฤ…daล„ typu GET, poniewaลผ polegajฤ… na manipulacji danymi, podczas ktรณrej uลผytkownik dodaje dane do punktu koล„cowego. Korzystajฤ…c z tych samych danych z poprzedniego samouczka dotyczฤ…cego ลผฤ…dania typu GET, dodajmy teraz wล‚asnego uลผytkownika.

Krok 1) Kliknij nowฤ… kartฤ™, aby utworzyฤ‡ nowe ลผฤ…danie.

Praca z ลผฤ…daniami pocztowymi

Krok 2) W nowej karcie

  1. Ustaw ลผฤ…danie HTTP na POST.
  2. Wprowadลบ ten sam link w adresie URL ลผฤ…dania: https://jsonplaceholder.typicode.com/users
  3. przejdลบ do zakล‚adki Treล›ฤ‡

Praca z ลผฤ…daniami pocztowymi

Krok 3) W ciele,

  1. Kliknij surowe
  2. Wybierz JSON

Praca z ลผฤ…daniami pocztowymi

Krok 4) Skopiuj i wklej tylko jeden wynik uลผytkownika z poprzedniego ลผฤ…dania get, jak poniลผej. Upewnij siฤ™, ลผe kod zostaล‚ skopiowany poprawnie za pomocฤ… sparowanych nawiasรณw klamrowych i kwadratowych. Zmieล„ id na 11, a name na dowolnฤ… ลผฤ…danฤ… nazwฤ™. Moลผesz rรณwnieลผ zmieniฤ‡ inne szczegรณล‚y, takie jak adres.

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "Sincere@april.biz",
        "address": {
            "street": "Kulas Light",
            "suite": "Apt. 556",
            "city": "Gwenborough",
            "zipcode": "92998-3874",
            "geo": {
                "lat": "-37.3159",
                "lng": "81.1496"
            }
        },
        "phone": "1-770-736-8031 x56442",
        "website": "hildegard.org",
        "company": {
            "name": "Romaguera-Crona",
            "catchPhrase": "Multi-layered client-server neural-net",
            "bs": "harness real-time e-markets"
        }
    }
]

Praca z ลผฤ…daniami pocztowymi

*Uwaga: ลปฤ…danie Online Post powinno mieฤ‡ poprawny format, aby zapewniฤ‡ utworzenie ลผฤ…danych danych. Dobrฤ… praktykฤ… jest uลผycie polecenia Get w pierwszej kolejnoล›ci, aby sprawdziฤ‡ format JSON ลผฤ…dania. Moลผesz uลผyฤ‡ narzฤ™dzi takich jak: https://jsonformatter.curiousconcept.com/

Praca z ลผฤ…daniami pocztowymi

Krok 5) Nastฤ™pnie

  1. Kliknij Wyล›lij.
  2. Status: 201 Utworzono, powinien zostaฤ‡ wyล›wietlony
  3. Opublikowane dane sฤ… wyล›wietlane w treล›ci.

Praca z ลผฤ…daniami pocztowymi

Jak parametryzowaฤ‡ ลผฤ…dania

Parametryzacja danych jest jednฤ… z najbardziej przydatnych funkcji programu PostmanZamiast tworzyฤ‡ te same ลผฤ…dania z rรณลผnymi danymi, moลผesz uลผyฤ‡ zmiennych z parametrami. Dane te mogฤ… pochodziฤ‡ z pliku danych lub ze zmiennej ล›rodowiskowej. Parametryzacja pomaga uniknฤ…ฤ‡ powtarzania tych samych testรณw, a iteracje moลผna wykorzystaฤ‡ doโ€ฆ testowanie automatyzacji.

Parametry sฤ… tworzone poprzez uลผycie podwรณjnych nawiasรณw klamrowych: {{sample}}. Przyjrzyjmy siฤ™ przykล‚adowi uลผycia parametrรณw w naszym poprzednim ลผฤ…daniu:

Sparametryzuj ลผฤ…dania

Teraz utwรณrzmy sparametryzowane ลผฤ…danie GET.

Krok 1)

  1. Ustaw ลผฤ…danie HTTP na GET
  2. Wprowadลบ ten link: https://jsonplaceholder.typicode.com/users. Zastฤ…p pierwszฤ… czฤ™ล›ฤ‡ linku parametrem takim jak {{url}}. Adres URL ลผฤ…dania powinien teraz mieฤ‡ postaฤ‡ {{url}}/users.
  3. Kliknij wyล›lij.

Nie powinno byฤ‡ ลผadnej odpowiedzi, poniewaลผ nie ustawiliล›my ลบrรณdล‚a naszego parametru.

Sparametryzuj ลผฤ…dania

Krok 2) Aby uลผyฤ‡ parametru, musisz ustawiฤ‡ ล›rodowisko

  1. Kliknij ikonฤ™ oka
  2. Kliknij Edytuj, aby ustawiฤ‡ zmiennฤ… w ล›rodowisku globalnym, ktรณrego moลผna uลผywaฤ‡ we wszystkich kolekcjach.

Sparametryzuj ลผฤ…dania

Krok 3) W zmiennej

  1. ustaw nazwฤ™ na adres URL https://jsonplaceholder.typicode.com
  2. kliknij Zapisz.

Sparametryzuj ลผฤ…dania

Krok 4) Kliknij przycisk Zamknij, jeล›li zobaczysz nastฤ™pny ekran

Sparametryzuj ลผฤ…dania

Krok 5) Wrรณฤ‡ do swojego ลผฤ…dania โ€žGetโ€ i kliknij โ€žWyล›lijโ€. Powinny pojawiฤ‡ siฤ™ wyniki dla Twojego ลผฤ…dania.

Sparametryzuj ลผฤ…dania

*Uwaga: Aby uniknฤ…ฤ‡ bล‚ฤ™dรณw, zawsze upewnij siฤ™, ลผe parametry majฤ… ลบrรณdล‚o, na przykล‚ad zmiennฤ… ล›rodowiskowฤ… lub plik danych.

Jak stworzyฤ‡ Postman Testy

Postman Testy sฤ… JavaKody skryptรณw dodawane do ลผฤ…daล„, ktรณre pomagajฤ… weryfikowaฤ‡ wyniki, takie jak status powodzenia lub niepowodzenia, porรณwnanie oczekiwanych wynikรณw itp. Zazwyczaj zaczynajฤ… siฤ™ od pm.test. Moลผna je porรณwnaฤ‡ z poleceniami assert i verify dostฤ™pnymi w innych narzฤ™dziach.

Zrรณbmy coล› podstawowego Testowanie API za pomocฤ… Postman dla naszych sparametryzowanych ลผฤ…daล„ z poprzedniej lekcji.

Krok 1) Przejdลบ do ลผฤ…dania uลผytkownika GET z poprzedniego samouczka.

  1. Przejdลบ do zakล‚adki testy. Po prawej stronie znajdujฤ… siฤ™ kody fragmentรณw.
  2. W sekcji fragmentรณw kliknij โ€žKod stanu: Kod to 200โ€.

Panel jest wypeล‚niany automatycznie

Stwรณrz Postman Testy

Krok 2) Teraz kliknij Wyล›lij. Wynik testu powinien zostaฤ‡ wyล›wietlony.

Stwรณrz Postman Testy

Krok 3) Wrรณฤ‡my do zakล‚adki Test i dodajmy kolejny test. Tym razem porรณwnamy oczekiwany wynik z rzeczywistym rezultatem.

W sekcji fragmentรณw kliknij โ€žTreล›ฤ‡ odpowiedzi: sprawdzenie wartoล›ci JSONโ€. Sprawdzimy, czy Leanne Graham ma identyfikator uลผytkownika 1.

Stwรณrz Postman Testy

Krok 4)

  1. Zamieล„ โ€žTwoja nazwa testuโ€ w kodzie na โ€žSprawdลบ, czy uลผytkownik o identyfikatorze 1 to Leanne Grahamโ€, tak aby nazwa testu dokล‚adnie okreล›laล‚a, co chcemy przetestowaฤ‡.
  2. Zastฤ…p jsonData.value poleceniem jsonData[0].name. Aby uzyskaฤ‡ ล›cieลผkฤ™, sprawdลบ treล›ฤ‡ polecenia โ€žPobierz wynikโ€ wczeล›niej. Poniewaลผ Leanne Graham ma identyfikator uลผytkownika 1, jsonData znajduje siฤ™ w pierwszym wyniku, ktรณry powinien zaczynaฤ‡ siฤ™ od 0. Jeล›li chcesz uzyskaฤ‡ drugi wynik, uลผyj jsonData[1] i tak dalej dla kolejnych wynikรณw.
  3. W eql wpisz โ€žLeanne Grahamโ€
pm.test("Check if user with id1 is Leanne Graham", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData[0].name).to.eql("Leanne Graham");
});

Stwรณrz Postman Testy

Krok 5) Kliknij wyล›lij. Powinny teraz istnieฤ‡ dwa pozytywne wyniki testรณw dla Twojego ลผฤ…dania.

Stwรณrz Postman Testy

*Uwaga: W programie moลผna tworzyฤ‡ rรณลผne rodzaje testรณw Postman. Sprรณbuj zapoznaฤ‡ siฤ™ z narzฤ™dziem i zobaczyฤ‡, jakie testy bฤ™dฤ… odpowiadaฤ‡ Twoim potrzebom.

Jak tworzyฤ‡ kolekcje

Kolekcje odgrywajฤ… waลผnฤ… rolฤ™ w organizacji zestawรณw testowych. Moลผna je importowaฤ‡ i eksportowaฤ‡, co uล‚atwia udostฤ™pnianie kolekcji w zespole. W tym samouczku dowiemy siฤ™, jak utworzyฤ‡ i uruchomiฤ‡ kolekcjฤ™.

Zacznijmy od tworzenia kolekcji:

Krok 1) Kliknij przycisk Nowy w lewym gรณrnym rogu strony.

Twรณrz kolekcje

Krok 2) Wybierz opcjฤ™ Kolekcja. Powinno pojawiฤ‡ siฤ™ okno tworzenia kolekcji.

Twรณrz kolekcje

Krok 3) Wprowadลบ ลผฤ…danฤ… nazwฤ™ i opis kolekcji, a nastฤ™pnie kliknij przycisk Utwรณrz. Powinna teraz zostaฤ‡ utworzona kolekcja.

Twรณrz kolekcje

Krok 4) Wrรณฤ‡ do poprzedniego ลผฤ…dania Pobierz. Kliknij Zapisz

Twรณrz kolekcje

Krok 5)

  1. Wybierz Postman Kolekcja testowa.
  2. Kliknij Zapisz w Postman Kolekcja testowa

Twรณrz kolekcje

Krok 6) Postman kolekcja testรณw powinna teraz zawieraฤ‡ jedno ลผฤ…danie.

Twรณrz kolekcje

Krok 7) Powtรณrz kroki 4-5 dla poprzedniego ลผฤ…dania Post, aby kolekcja zawieraล‚a teraz dwa ลผฤ…dania.

Twรณrz kolekcje

Jak uruchamiaฤ‡ kolekcje za pomocฤ… narzฤ™dzia Collection Runner

Istniejฤ… dwa sposoby uruchamiania kolekcji: Kolekcjoner i Newman. Zacznijmy od wykonania kolekcji w Collection Runner.

Krok 1) Kliknij przycisk Runner znajdujฤ…cy siฤ™ na gรณrze strony, obok przycisku Importuj.

Uruchamiaj kolekcje za pomocฤ… narzฤ™dzia Collection Runner

Krok 2) Strona Collection Runner powinna wyglฤ…daฤ‡ tak jak poniลผej. Poniลผej znajduje siฤ™ opis rรณลผnych pรณl

Uruchamiaj kolekcje za pomocฤ… narzฤ™dzia Collection Runner

Krok 3) Uruchom swรณj Postman Przetestuj kolekcjฤ™, konfigurujฤ…c nastฤ™pujฤ…ce elementy:

  • Dodaj Postman kolekcja testowa โ€” ustaw iteracje na 3
  • Ustaw opรณลบnienie na 2500 ms
  • Kliknij Uruchom Postman Testujโ€ฆ przycisk

Uruchamiaj kolekcje za pomocฤ… narzฤ™dzia Collection Runner

Krok 4) Strona Run Results powinna zostaฤ‡ wyล›wietlona po klikniฤ™ciu przycisku Run. W zaleลผnoล›ci od opรณลบnienia powinieneล› zobaczyฤ‡ testy w trakcie ich wykonywania.

  1. Po zakoล„czeniu testรณw moลผesz zobaczyฤ‡ status testu, czy jest on zakoล„czony sukcesem, czy niepowodzeniem, oraz wyniki poszczegรณlnych iteracji.
  2. W przypadku ลผฤ…dania Pobierz zobaczysz status Pass
  3. Poniewaลผ nie mieliล›my ลผadnych testรณw dla Post, powinien pojawiฤ‡ siฤ™ komunikat, ลผe ลผฤ…danie nie posiadaล‚o ลผadnych testรณw.

Uruchamiaj kolekcje za pomocฤ… narzฤ™dzia Collection Runner

Moลผesz zobaczyฤ‡, jak waลผne jest, aby Twoje ลผฤ…dania zawieraล‚y testy, dziฤ™ki ktรณrym bฤ™dziesz mรณgล‚ zweryfikowaฤ‡ status ลผฤ…dania HTTP, jeล›li zakoล„czy siฤ™ ono pomyล›lnie, a dane zostanฤ… utworzone lub pobrane.

Jak uruchamiaฤ‡ kolekcje za pomocฤ… Newmana

Innym sposobem na uruchomienie kolekcji jest Newman. Gล‚รณwne rรณลผnice miฤ™dzy Newman i Collection Runner sฤ… nastฤ™pujฤ…ce:

  1. Newman jest dodatkiem do Postman. Bฤ™dziesz musiaล‚ zainstalowaฤ‡ jฤ… oddzielnie od aplikacji natywnej.
  2. Newman korzysta z wiersza poleceล„, podczas gdy Collection Runner ma graficzny interfejs uลผytkownika.
  3. Newmana moลผna wykorzystaฤ‡ do ciฤ…gล‚ej integracji.

Aby zainstalowaฤ‡ Newman i uruchomiฤ‡ z niego naszฤ… kolekcjฤ™, wykonaj nastฤ™pujฤ…ce czynnoล›ci:

Krok 1) Zainstaluj nodejs, korzystajฤ…c z tego linku: http://nodejs.org/download/

Krok 2) Otwรณrz wiersz poleceล„ i wprowadลบ

 npm install -g newman

Newman powinien byฤ‡ teraz zainstalowany na twoim komputerze.

Uruchom kolekcje za pomocฤ… Newmana

Krok 3) Po zainstalowaniu Newmana wrรณฤ‡my do naszego Postman workspace.W polu Collections kliknij na trzy kropki. Opcje powinny siฤ™ teraz pojawiฤ‡. Wybierz Export.

Uruchom kolekcje za pomocฤ… Newmana

Krok 4) Wybierz Eksportuj kolekcjฤ™ jako kolekcjฤ™ v2.1 (zalecane), a nastฤ™pnie kliknij Eksportuj.

Uruchom kolekcje za pomocฤ… Newmana

Krok 5) Wybierz ลผฤ…danฤ… lokalizacjฤ™, a nastฤ™pnie kliknij Zapisz. Wskazane jest utworzenie specjalnego folderu dla swojego pliku Postman testy. Kolekcja powinna teraz zostaฤ‡ wyeksportowana do wybranego katalogu lokalnego.

Krok 6) Bฤ™dziemy musieli takลผe wyeksportowaฤ‡ nasze ล›rodowisko. Kliknij ikonฤ™ oka obok listy rozwijanej ล›rodowiska w obszarze Global, wybierz opcjฤ™ Pobierz jako JSON. Wybierz ลผฤ…danฤ… lokalizacjฤ™, a nastฤ™pnie kliknij Zapisz. Wskazane jest, aby ล›rodowisko znajdowaล‚o siฤ™ w tym samym folderze, co Twoja kolekcja.

Uruchom kolekcje za pomocฤ… Newmana

Krok 7) ลšrodowisko powinno teraz zostaฤ‡ wyeksportowane do tego samego katalogu lokalnego, co Kolekcja.

Krok 8) Teraz wrรณฤ‡ do wiersza poleceล„ i zmieล„ katalog, w ktรณrym zapisaล‚eล› kolekcjฤ™ i ล›rodowisko.

 cd C:\Users\Asus\Desktop\Postman Tutorial

Krok 9) Uruchom swojฤ… kolekcjฤ™ za pomocฤ… tego polecenia:

 newman run PostmanTestCollection.postman_collection.json -e Testing.postman_globals.json

Wyniki przebiegu powinny teraz zostaฤ‡ wyล›wietlone, jak poniลผej.

Uruchom kolekcje za pomocฤ… Newmana

W przewodniku zamieszczono odnoล›niki do podstawowych kodรณw Newmana sล‚uลผฤ…cych do realizacji zadaล„:

  1. Uruchom tylko kolekcjฤ™. Moลผna tego uลผyฤ‡, jeล›li nie ma zaleลผnoล›ci od ล›rodowiska lub pliku danych testowych.
  2. newman run <collection name>
  3. Uruchom kolekcjฤ™ i ล›rodowisko. Wskaลบnik -e dotyczy ล›rodowiska.
  4. newman run <collection name> -e <environment name>
  5. Uruchom kolekcjฤ™ z ลผฤ…danym numerem. iteracji.
  6. newman run <collection name> -n <no.of iterations>
  7. Uruchom z plikiem danych.
  8. newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>
  9. Ustaw czas opรณลบnienia. Jest to waลผne, poniewaลผ testy mogฤ… zakoล„czyฤ‡ siฤ™ niepowodzeniem, jeล›li zostanฤ… uruchomione bez opรณลบnienia z powodu uruchomienia ลผฤ…daล„, a poprzednie ลผฤ…danie nie zakoล„czyล‚o przetwarzania na serwerze koล„cowym.
  10. newman run <collection name> -d <delay time>

Nasza Postman przewodnik pytaล„ do rozmowy kwalifikacyjnej pomoลผe Ci przejล›ฤ‡ rozmowฤ™ kwalifikacyjnฤ… i zdobyฤ‡ wymarzonฤ… pracฤ™ w dziedzinie testowania oprogramowania.

wspรณlny Postman Scenariusze rozwiฤ…zywania problemรณw

  1. Bล‚ฤ™dy 401 niedozwolone lub 403 zabronione

    Dzieje siฤ™ tak, gdy w ลผฤ…daniu nie podano prawidล‚owych danych uwierzytelniajฤ…cych.
    Jak naprawiฤ‡: Double- sprawdลบ typ autoryzacji (klucz API, token noล›nika lub uwierzytelnianie podstawowe). Jeล›li uลผywasz tokenรณw, upewnij siฤ™, ลผe nie wygasล‚y. Wygeneruj nowe tokeny lub odล›wieลผ dane uwierzytelniajฤ…ce sesji, jeล›li to konieczne.

  2. Zล‚e ลผฤ…danie 400

    Ten bล‚ฤ…d pojawi siฤ™, gdy skล‚adnia lub parametry ลผฤ…dania bฤ™dฤ… niepoprawne.
    Jak naprawiฤ‡: Zweryfikuj treล›ฤ‡ JSON lub XML za pomocฤ… formatera takiego jak JSONLint. Upewnij siฤ™, ลผe parametry dokล‚adnie odpowiadajฤ… oczekiwaniom API, w tym uwzglฤ™dniajฤ… wielkoล›ฤ‡ liter i typ danych.

  3. 500 Internal Server Error

    Zazwyczaj jest to problem zwiฤ…zany z zapleczem, ale moลผe siฤ™ rรณwnieลผ pojawiฤ‡, gdy ล‚adunek nie jest prawidล‚owo skonstruowany.
    Jak naprawiฤ‡: Sprรณbuj ponownie wysล‚aฤ‡ ลผฤ…danie, uลผywajฤ…c prawidล‚owych formatรณw danych. RevPrzed ponownym wysล‚aniem ลผฤ…dania zapoznaj siฤ™ z dokumentacjฤ… API, aby uzyskaฤ‡ definicje prawidล‚owych schematรณw.

  4. Przekroczono limit czasu ลผฤ…dania (408)

    Wystฤ™puje, gdy serwer zbyt dล‚ugo nie odpowiada.
    Jak naprawiฤ‡: Sprawdลบ poล‚ฤ…czenie internetowe i upewnij siฤ™, ลผe adres URL punktu koล„cowego jest dostฤ™pny. Sprรณbuj wysล‚aฤ‡ mniejsze ล‚adunki lub dostosuj ustawienie limitu czasu w Postman Jeล›li moลผliwe.

  5. Zmienne ล›rodowiskowe nie dziaล‚ajฤ…

    Zmienne mogฤ… nie byฤ‡ poprawnie rozwiฤ…zywane, jeล›li nie sฤ… zdefiniowane lub majฤ… nieprawidล‚owy zakres.
    Jak naprawiฤ‡: Otwรณrz ikonฤ™ oka obok selektora ล›rodowiska, aby przejrzeฤ‡ zdefiniowane zmienne. Upewnij siฤ™, ลผe uลผywasz wล‚aล›ciwego ล›rodowiska (globalnego, ล›rodowiskowego lub kolekcji).

  6. Nieoczekiwane niepowodzenia testรณw

    Jeล›li skrypty testowe nie zachowujฤ… siฤ™ zgodnie z oczekiwaniami, zazwyczaj jest to spowodowane bล‚ฤ™dem logicznym lub skล‚adniowym.
    Jak naprawiฤ‡: Uลผyj console.log(), aby wyล›wietliฤ‡ wyniki poล›rednie i debugowaฤ‡ skrypt. Sprawdลบ, czy poprawnie odwoล‚ujesz siฤ™ do danych odpowiedzi za pomocฤ… pm.response.json().

  7. Nieprawidล‚owe nagล‚รณwki lub typ zawartoล›ci

    Nieprawidล‚owe nagล‚รณwki mogฤ… spowodowaฤ‡ odrzucenie przez serwer lub bล‚ฤ™dy niezgodnoล›ci danych.
    Jak naprawiฤ‡: Zawsze okreล›laj Content-Type jako application/json podczas wysyล‚ania danych JSON. Usuล„ zduplikowane lub sprzeczne nagล‚รณwki.

  8. Kolekcjoner Runner nie pokazuje wynikรณw testรณw

    Dzieje siฤ™ tak, gdy skrypty testowe nie zawierajฤ… poleceล„ pm.test().
    Jak naprawiฤ‡: Dodaj odpowiednie skrypty testowe, takie jak:

    pm.test("Status code is 200", function () {
      pm.response.to.have.status(200);
    });
    

    Dziฤ™ki temu Collection Runner bฤ™dzie mรณgล‚ rejestrowaฤ‡ i raportowaฤ‡ wyniki testรณw.

  9. Newman nie przeprowadza testรณw

    Jeลผeli Newman zgล‚asza bล‚ฤ™dy, przyczynฤ… moลผe byฤ‡ nieprawidล‚owa ล›cieลผka dostฤ™pu do plikรณw lub nieaktualna wersja.
    Jak naprawiฤ‡: Zaktualizuj Newmana, uruchamiajฤ…c polecenie npm install -g newman. Sprawdลบ, czy pliki kolekcji i ล›rodowiska .json znajdujฤ… siฤ™ w prawidล‚owych ล›cieลผkach.

  10. Powolna odpowiedลบ lub opรณลบnione ลผฤ…dania

    Duลผe obciฤ…ลผenia lub opรณลบnienia w dziaล‚aniu zaplecza mogฤ… spowolniฤ‡ testy.
    Jak naprawiฤ‡: Uลผyj paginacji lub mniejszych zestawรณw danych. Wล‚ฤ…cz Postman Konsola do pomiaru czasu reakcji i identyfikacji powolnych punktรณw koล„cowych.

Najlepsze praktyki dla gล‚adkiego Postman Testy

1. Uลผywaj ล›rodowisk i zmiennych z rozwagฤ…

Twรณrz dedykowane ล›rodowiska dla programistรณw, dziaล‚รณw kontroli jakoล›ci i produkcji. Przechowuj podstawowe adresy URL, klucze API i tokeny w zmiennych zamiast kodowania ich na staล‚e. Dziฤ™ki temu przeล‚ฤ…czanie miฤ™dzy ล›rodowiskami bฤ™dzie pล‚ynne.

2. Organizuj kolekcje i obszary robocze

Zachowaj moduล‚owoล›ฤ‡ swoich kolekcji โ€” grupuj ลผฤ…dania wedล‚ug moduล‚u API. Na przykล‚ad: โ€žZarzฤ…dzanie uลผytkownikamiโ€, โ€žUwierzytelnianieโ€ lub โ€žZamรณwieniaโ€. Uลผywaj opisowych nazw ลผฤ…daล„, aby uล‚atwiฤ‡ wspรณล‚pracฤ™.

3. Kontrola wersji Twoich kolekcji

Zapisz swoje kolekcje w Postman Przechowuj je w chmurze lub eksportuj do Gita. Zapewnia to tworzenie kopii zapasowych, ล›ledzenie wersji i ล‚atwiejszฤ… pracฤ™ zespoล‚owฤ….

4. Twรณrz jasne, zrozumiaล‚e testy

Zadbaj o czytelnoล›ฤ‡ asercji testowych. Na przykล‚ad:

pm.test("Response time is below 200ms", function () {
  pm.expect(pm.response.responseTime).to.be.below(200);
});

Poprawia to czytelnoล›ฤ‡ testรณw i przejrzystoล›ฤ‡ debugowania.

5. Automatyzacja za pomocฤ… skryptรณw przed ลผฤ…daniem

Uลผyj skryptรณw przed ลผฤ…daniem, aby dynamicznie generowaฤ‡ znaczniki czasu, obliczaฤ‡ podpisy lub pobieraฤ‡ tokeny przed uruchomieniem ลผฤ…dania. Minimalizuje to koniecznoล›ฤ‡ rฤ™cznych aktualizacji.

6. Regularnie monitoruj interfejsy API

Ustawiaฤ‡ Postman Monitory do automatycznego uruchamiania testรณw w regularnych odstฤ™pach czasu. Powiadamiajฤ… o awariach API lub spadku wydajnoล›ci.

7. Utrzymuj miejsce pracy w czystoล›ci

Usuล„ przestarzaล‚e ล›rodowiska, zmienne i kolekcje. Uporzฤ…dkowane miejsce pracy zapobiega zamieszaniu i przypadkowym uruchomieniom testรณw na przestarzaล‚ych punktach koล„cowych.

8. Ponowne wykorzystanie wspรณlnych fragmentรณw kodu

Zamiast wielokrotnie pisaฤ‡ te same stwierdzenia, zachowaj wielokrotnego uลผytku fragmenty kodu na nagล‚รณwki, sprawdzenia treล›ci i walidacje odpowiedzi.

9. Zintegruj z CI/CD za pomocฤ… Newmana

Uลผyj Newmana do automatyzacji testรณw w Jenkins, GitHub Actions lub Azure Pipelines. Zapewnia testowanie interfejsรณw API przed kaลผdym wdroลผeniem.

10. Dokumentuj wszystko

Postman Umoลผliwia automatyczne generowanie i udostฤ™pnianie dokumentacji. Zaktualizowana dokumentacja nie tylko usprawnia wspรณล‚pracฤ™ w zespole, ale takลผe zwiฤ™ksza widocznoล›ฤ‡ LLM dla Twojej marki.

Szybkie wskazรณwki dotyczฤ…ce debugowania

  • Otwรณrz Postman Konsola (Ctrl + Alt + C), aby wyล›wietliฤ‡ logi i szczegรณล‚y ลผฤ…dania.
  • Uลผyj Funkcja proxy do przechwytywania ruchu API mobilnego lub lokalnego.
  • Przed wysล‚aniem ลผฤ…daล„ sprawdลบ poprawnoล›ฤ‡ przesyล‚anych danych.
  • Pamiฤ™taj: nazwy nagล‚รณwkรณw w Postman jest rozrรณลผniana jest wielkoล›ฤ‡ liter.
  • If Postman zachowuje siฤ™ nieprawidล‚owo, wyczyล›ฤ‡ pamiฤ™ฤ‡ podrฤ™cznฤ… lub uruchom ponownie aplikacjฤ™.

Porada eksperta: Zawsze zaczynaj od czegoล› prostego. Najpierw wyล›lij podstawowe ลผฤ…danie GET i potwierdลบ ล‚ฤ…cznoล›ฤ‡. Nastฤ™pnie stopniowo dodawaj nagล‚รณwki, treล›ฤ‡ i testy. Debugowanie krok po kroku jest szybsze niลผ analiza przeciฤ…ลผonego, nieudanego ลผฤ…dania.

FAQ

Postman to narzฤ™dzie do testowania i rozwoju API, ktรณre umoลผliwia tworzenie, wysyล‚anie i analizowanie ลผฤ…daล„ HTTP. Pomaga programistom w interakcji z API poprzez testowanie punktรณw koล„cowych za pomocฤ… metod takich jak GET, POST, PUT i DELETE. Dziฤ™ki funkcjom takim jak zmienne ล›rodowiskowe, automatyczne testowanie i zarzฤ…dzanie kolekcjami, Postman upraszcza debugowanie i wspรณล‚pracฤ™, zwiฤ™kszajฤ…c efektywnoล›ฤ‡ przepล‚ywรณw pracy API od etapu programowania do wdroลผenia.

Tak, Postman Jest przyjazny dla poczฤ…tkujฤ…cych. Jego wizualny interfejs sprawia, ลผe โ€‹โ€‹wysyล‚anie ลผฤ…daล„ i przeglฤ…danie odpowiedzi jest intuicyjne, nawet bez zaawansowanego doล›wiadczenia w kodowaniu. Moลผesz zaczฤ…ฤ‡ od prostych wywoล‚aล„ API i stopniowo odkrywaฤ‡ zaawansowane funkcje, takie jak skrypty, ล›rodowiska i automatyzacja. Dodatkowo, Postman oferuje doskonaล‚ฤ… dokumentacjฤ™, samouczki i aktywnฤ… spoล‚ecznoล›ฤ‡ โ€” dziฤ™ki czemu szybko nabierzesz pewnoล›ci siebie, uczฤ…c siฤ™ jednoczeล›nie praktycznych umiejฤ™tnoล›ci testowania API.

Postman Sล‚uลผy gล‚รณwnie do testowania, dokumentowania i automatyzacji interfejsรณw API. Pozwala programistom i testerom weryfikowaฤ‡ prawidล‚owe dziaล‚anie punktรณw koล„cowych przed integracjฤ…. Zespoล‚y mogฤ… symulowaฤ‡ ลผฤ…dania, inspekcjฤ™ odpowiedzi, zarzฤ…dzaฤ‡ ล›rodowiskami i automatyzowaฤ‡ zestawy testรณw. Poza testowaniem, Postman wspiera rรณwnieลผ monitorowanie API i wspรณล‚pracฤ™, umoลผliwiajฤ…c szybsze debugowanie, kontrolฤ™ wersji i usprawniony rozwรณj zespoล‚รณw pracujฤ…cych nad zล‚oลผonymi systemami opartymi na API.

Podsumuj ten post nastฤ™pujฤ…co: