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": "[email protected]",
        "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: