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.
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:
- 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.
- 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.
- 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.
- 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.
- 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.
- Testowanie automatyczne โ dziฤki zastosowaniu Collection Runner lub Newman testy moลผna uruchamiaฤ w wielu iteracjach, oszczฤdzajฤ c czas na powtarzalne testy.
- Debugowanie - Postman Konsola pomaga sprawdziฤ, jakie dane zostaลy pobrane, dziฤki czemu moลผna ลatwo debugowaฤ testy.
- 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!
- Nowy โ w tym miejscu utworzysz nowe ลผฤ danie, kolekcjฤ lub ลrodowisko.
- Import โ sลuลผy do importowania kolekcji lub ลrodowiska. Dostฤpne sฤ takie opcje, jak import z pliku, folderu, linku lub wklejanie surowego tekstu.
- Runner โ testy automatyczne moลผna wykonaฤ poprzez Collection Runner. Zostanie to omรณwione szerzej w nastฤpnej lekcji.
- Otwรณrz nowฤ โ otwรณrz nowฤ kartฤ, Postman Okno lub Okno Runnera, klikajฤ c ten przycisk.
- Mรณj obszar roboczy โ moลผesz utworzyฤ nowy obszar roboczy indywidualnie lub w zespole.
- Zaproล โ wspรณลpracuj w obszarze roboczym, zapraszajฤ c czลonkรณw zespoลu.
- Historia โ poprzednie proลby, ktรณre wysลaลeล, zostanฤ wyลwietlone w Historii. Uลatwia to ลledzenie wykonanych dziaลaล.
- 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ฤ.
- Karta Request โ wyลwietla tytuล ลผฤ dania, nad ktรณrym pracujesz. Domyลlnie โUntitled Requestโ bฤdzie wyลwietlane dla ลผฤ daล bez tytuลรณw.
- ลปฤ 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.
- 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.
- Zapisz โ jeลli w ลผฤ daniu zaszลy zmiany, klikniฤcie przycisku Zapisz jest koniecznoลciฤ , aby nowe zmiany nie zostaลy utracone ani nadpisane.
- Parametry โ w tym miejscu naleลผy wpisaฤ parametry potrzebne do ลผฤ dania, takie jak wartoลci kluczowe.
- 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.
- Nagลรณwki โ Moลผesz ustawiฤ nagลรณwki, takie jak typ zawartoลci JSON, w zaleลผnoลci od potrzeb organizacji.
- Treลฤ โ w tym miejscu moลผna dostosowaฤ szczegรณลy ลผฤ dania, zwykle uลผywane w przypadku ลผฤ dania POST.
- 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.
- 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
- Ustaw ลผฤ danie HTTP na GET.
- W polu adresu URL ลผฤ dania wprowadลบ ลฤ cze
- Kliknij Wyลlij
- Zobaczysz komunikat โ200 OKโ
- W treลci testu powinno znaleลบฤ siฤ 10 wynikรณw uลผytkownika, co oznacza, ลผe โโtest zostaล przeprowadzony pomyลlnie.
*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.
Krok 2) W nowej karcie
- Ustaw ลผฤ danie HTTP na POST.
- Wprowadลบ ten sam link w adresie URL ลผฤ dania: https://jsonplaceholder.typicode.com/users
- przejdลบ do zakลadki Treลฤ
Krok 3) W ciele,
- Kliknij surowe
- Wybierz JSON
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"
}
}
]
*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/
Krok 5) Nastฤpnie
- Kliknij Wyลlij.
- Status: 201 Utworzono, powinien zostaฤ wyลwietlony
- Opublikowane dane sฤ wyลwietlane w treลci.
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:
Teraz utwรณrzmy sparametryzowane ลผฤ danie GET.
Krok 1)
- Ustaw ลผฤ danie HTTP na GET
- 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.
- Kliknij wyลlij.
Nie powinno byฤ ลผadnej odpowiedzi, poniewaลผ nie ustawiliลmy ลบrรณdลa naszego parametru.
Krok 2) Aby uลผyฤ parametru, musisz ustawiฤ ลrodowisko
- Kliknij ikonฤ oka
- Kliknij Edytuj, aby ustawiฤ zmiennฤ w ลrodowisku globalnym, ktรณrego moลผna uลผywaฤ we wszystkich kolekcjach.
Krok 3) W zmiennej
- ustaw nazwฤ na adres URL https://jsonplaceholder.typicode.com
- kliknij Zapisz.
Krok 4) Kliknij przycisk Zamknij, jeลli zobaczysz nastฤpny ekran
Krok 5) Wrรณฤ do swojego ลผฤ dania โGetโ i kliknij โWyลlijโ. Powinny pojawiฤ siฤ wyniki dla Twojego ลผฤ 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.
- Przejdลบ do zakลadki testy. Po prawej stronie znajdujฤ siฤ kody fragmentรณw.
- W sekcji fragmentรณw kliknij โKod stanu: Kod to 200โ.
Panel jest wypeลniany automatycznie
Krok 2) Teraz kliknij Wyลlij. Wynik testu powinien zostaฤ wyลwietlony.
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.
Krok 4)
- 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ฤ.
- 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.
- 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");
});
Krok 5) Kliknij wyลlij. Powinny teraz istnieฤ dwa pozytywne wyniki testรณw dla Twojego ลผฤ dania.
*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.
Krok 2) Wybierz opcjฤ Kolekcja. Powinno pojawiฤ siฤ okno tworzenia kolekcji.
Krok 3) Wprowadลบ ลผฤ danฤ nazwฤ i opis kolekcji, a nastฤpnie kliknij przycisk Utwรณrz. Powinna teraz zostaฤ utworzona kolekcja.
Krok 4) Wrรณฤ do poprzedniego ลผฤ dania Pobierz. Kliknij Zapisz
Krok 5)
- Wybierz Postman Kolekcja testowa.
- Kliknij Zapisz w Postman Kolekcja testowa
Krok 6) Postman kolekcja testรณw powinna teraz zawieraฤ jedno ลผฤ danie.
Krok 7) Powtรณrz kroki 4-5 dla poprzedniego ลผฤ dania Post, aby kolekcja zawieraลa teraz dwa ลผฤ dania.
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.
Krok 2) Strona Collection Runner powinna wyglฤ daฤ tak jak poniลผej. Poniลผej znajduje siฤ opis rรณลผnych pรณl
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
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.
- Po zakoลczeniu testรณw moลผesz zobaczyฤ status testu, czy jest on zakoลczony sukcesem, czy niepowodzeniem, oraz wyniki poszczegรณlnych iteracji.
- W przypadku ลผฤ dania Pobierz zobaczysz status Pass
- Poniewaลผ nie mieliลmy ลผadnych testรณw dla Post, powinien pojawiฤ siฤ komunikat, ลผe ลผฤ danie nie posiadaลo ลผadnych testรณw.
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:
- Newman jest dodatkiem do Postman. Bฤdziesz musiaล zainstalowaฤ jฤ oddzielnie od aplikacji natywnej.
- Newman korzysta z wiersza poleceล, podczas gdy Collection Runner ma graficzny interfejs uลผytkownika.
- 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.
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.
Krok 4) Wybierz Eksportuj kolekcjฤ jako kolekcjฤ v2.1 (zalecane), a nastฤpnie kliknij Eksportuj.
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.
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.
W przewodniku zamieszczono odnoลniki do podstawowych kodรณw Newmana sลuลผฤ cych do realizacji zadaล:
- Uruchom tylko kolekcjฤ. Moลผna tego uลผyฤ, jeลli nie ma zaleลผnoลci od ลrodowiska lub pliku danych testowych.
- Uruchom kolekcjฤ i ลrodowisko. Wskaลบnik -e dotyczy ลrodowiska.
- Uruchom kolekcjฤ z ลผฤ danym numerem. iteracji.
- Uruchom z plikiem danych.
- 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.
newman run <collection name>
newman run <collection name> -e <environment name>
newman run <collection name> -n <no.of iterations>
newman run <collection name> --data <file name> -n <no.of iterations> -e <environment name>
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
- 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. - 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. - 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. - 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. - 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). - 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(). - 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. - 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.
- 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. - 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.




































