Aby testować API REST za pomocą aplikacji Postman na Ubuntu, należy przejść przez kilka etapów: od instalacji, przez konfigurację środowiska, aż po realizację i automatyzację testów. Ten poradnik został przygotowany z myślą o użytkownikach Linuksa, ze szczególnym uwzględnieniem Ubuntu, i prowadzi krok po kroku przez cały proces.
1. Czym jest Postman i do czego służy?
Postman to aplikacja wspierająca testowanie, rozwijanie oraz dokumentowanie API, wykorzystywana zarówno przez programistów, jak i testerów. Pozwala realizować żądania HTTP do serwisów REST, analizować odpowiedzi, budować kolekcje testów, a także automatyzować testowanie.
2. Instalacja Postmana na Ubuntu
Możesz zainstalować Postmana za pomocą Snap lub Flatpak – poniżej oba sposoby:
Metoda 1 – Instalacja przez Snap
- Zaktualizuj pakiety systemowe:
sudo apt update - Upewnij się, że masz zainstalowanego Snapd (Snap jest domyślnie obecny na Ubuntu):
sudo apt install snapd - Zainstaluj Postmana:
sudo snap install postman Po instalacji znajdziesz Postmana w menu aplikacji. Wystarczy go uruchomić, klikając ikonę Postmana lub przez terminal za pomocą komendy postman.
Metoda 2 – Instalacja przez Flatpak
- Zainstaluj Flatpak:
sudo apt install flatpak - Dodaj repozytorium Flathub:
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo - Zainstaluj Postmana:
flatpak install flathub com.getpostman.Postman - Uruchom aplikację:
flatpak run com.getpostman.Postman 3. Podstawy HTTP w testowaniu API
Zanim rozpoczniesz testy, warto znać podstawowe metody HTTP wykorzystywane w REST API:
- GET – pobiera dane
- POST – przesyła nowe dane na serwer
- PUT – aktualizuje istniejące dane
- DELETE – usuwa wskazane dane
To są podstawowe operacje CRUD (Create, Read, Update, Delete).
4. Pierwsze uruchomienie i interfejs Postmana
Po uruchomieniu aplikacji możesz zalogować się na konto Postman (opcjonalne) – umożliwia to synchronizację testów w chmurze.
Główne elementy interfejsu:
- Pasek nawigacyjny z możliwością tworzenia nowych kolekcji i żądań
- Pole edycji zapytania (URL, metoda HTTP)
- Zakładki do ustawień nagłówków, ciała żądania (Body), autoryzacji i parametrów
5. Wysyłanie pierwszego zapytania do API
Przykład: Pobieranie wszystkich użytkowników z przykładowego API.
Krok po kroku –
- Kliknij „New” → „HTTP Request”.
- Wybierz metodę GET.
- W polu URL wpisz np.:
https://jsonplaceholder.typicode.com/users - Kliknij „Send”.
W sekcji „Response” pojawi się odpowiedź serwera wraz z kodem statusu HTTP, nagłówkami i treścią odpowiedzi (w formacie JSON lub innym zależnie od API).
6. Tworzenie i zapisywanie testów w kolekcji
Kolekcje pozwalają grupować testy API, np. według funkcjonalności.
- W menu bocznym kliknij „New Collection”.
- Nazwij kolekcję, np. „DemoAPI”.
- Dodawaj poszczególne żądania, zapisując każde (Ctrl+S lub ikonka dyskietki).
7. Przykłady wysyłania różnych metod
POST (tworzenie zasobu) –
- Wybierz metodę POST
- Podaj URL (np.
https://jsonplaceholder.typicode.com/posts) - W sekcji „Body” wybierz „raw” i jako format „JSON”
- Wklej przykładowe dane:
{ "title": "foo", "body": "bar", "userId": 1 } - Kliknij „Send” – odpowiedź powinna zawierać utworzony obiekt.
PUT (aktualizacja) –
- Metoda PUT
- Treść żądania podobna jak przy POST, ale skierowana do konkretnego zasobu (np.
/posts/1).
DELETE (usuwanie) –
- Metoda DELETE, URL: np.
https://jsonplaceholder.typicode.com/posts/1 - Kliknij „Send” – zasób zostanie usunięty lub otrzymasz potwierdzenie usunięcia.
8. Parametry, nagłówki i autoryzacja
- Headers – Ustawiaj wymagane nagłówki jak
Content-Type,Authorization, itp. - Params – Dodawaj parametry do zapytań GET poprzez zakładkę „Params”.
- Authorization – Postman obsługuje różne typy autentykacji (Bearer Token, Basic Auth, OAuth itp.).
9. Testowanie odpowiedzi (testy automatyczne)
W zakładce Tests (pod polem odpowiedzi) możesz automatyzować weryfikację odpowiedzi, np.:
pm.test("Status code is 200", function () { pm.response.to.have.status(200); }); pm.test("Body contains userId", function () { pm.response.to.have.jsonBody('userId'); }); Wyniki testów pojawią się w sekcji „Test Results” po wysłaniu żądania.
10. Wskazówki i dobre praktyki
- Twórz kolekcje, by porządkować testy.
- Używaj zmiennych środowiskowych (np. dla adresów API, tokenów).
- Exportuj/importuj kolekcje (przydatne w pracy zespołowej).
- Dokumentuj każde żądanie – ułatwiaj sobie i innym analizę testów.
Postman na Ubuntu to jedno z najprostszych rozwiązań do testowania API REST – zarówno dla początkujących, jak i zaawansowanych użytkowników. Więcej praktycznych przykładów znajdziesz również w licznych materiałach wideo oraz na blogach poświęconych testowaniu aplikacji REST.
