Postman – testowanie API

Dlaczego Postman jest niezbędny każdemu developerowi?

Testowanie API za pomocą curl w terminalu to nightmare dla większości programistów. Postman rozwiązuje ten problem oferując przyjazny interfejs graficzny do wysyłania żądań HTTP, sprawdzania odpowiedzi i organizowania testów. To jak przejście z notepad na prawdziwe IDE – once you go Postman, you never go back.

Czym jest Postman?

Postman to aplikacja desktopowa która zastępuje skomplikowane komendy curl prostym interfejsem typu point-and-click. Zamiast pisać:

curl -X POST http://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

Po prostu klikasz, wpisujesz dane w formularz i naciskasz Send. Prostsze, szybsze i mniej podatne na błędy.

Instalacja i pierwsze uruchomienie

Download i instalacja

1. Idź na https://www.getpostman.com/
2. Kliknij „Download the App” (desktop app jest lepsza niż Chrome extension)
3. Zainstaluj jak każdą normalną aplikację
4. Uruchom – nie musisz się rejestrować, kliknij „Skip signing in”

Pierwszy test API – GET request

Przetestujmy publiczne API które zwraca informacje o użytkownikach:

Krok po kroku:

1. Otwórz nowy request: Kliknij „New” → „Request”
2. Wpisz URL: https://jsonplaceholder.typicode.com/users/1
3. Wybierz metodę: GET (domyślnie jest wybrane)
4. Kliknij Send

Co zobaczysz w odpowiedzi:

{
  "id": 1,
  "name": "Leanne Graham",
  "username": "Bret",
  "email": "Sincere@april.biz",
  "address": {
    "street": "Kulas Light",
    "suite": "Apt. 556",
    "city": "Gwenborough",
    "zipcode": "92998-3874"
  },
  "phone": "1-770-736-8031 x56442",
  "website": "hildegard.org"
}

W dolnej części zobaczysz też ważne informacje:

• Status: 200 OK (request się udał)
• Time: czas odpowiedzi w milisekundach
• Size: rozmiar odpowiedzi

Wysyłanie POST request – tworzenie danych

Teraz wyślijmy dane do API. Stworzymy nowego użytkownika:

Konfiguracja POST request:

1. Nowy request: „New” → „Request”
2. URL: https://jsonplaceholder.typicode.com/users
3. Metoda: Zmień z GET na POST
4. Headers: Dodaj Content-Type
   • Key: Content-Type
   • Value: application/json
5. Body: Kliknij tab „Body” → „raw” → wklej JSON:

{
  "name": "Jan Kowalski",
  "username": "janko",
  "email": "jan@example.com",
  "phone": "123-456-789"
}

Organizowanie żądań w Collections

Collections to sposób na organizowanie związanych ze sobą API requests – jak foldery dla plików.

Tworzenie Collection:

1. Kliknij „New” → „Collection”
2. Nazwa: „User API Tests”
3. Opis: „Testing user CRUD operations”
4. Zapisz requests: W każdym request kliknij „Save” i wybierz Collection

Podstawowe typy żądań HTTP

Przykład DELETE request:

1. URL: https://jsonplaceholder.typicode.com/users/1
2. Metoda: DELETE
3. Send – powinieneś dostać status 200 lub 204

Sprawdzanie odpowiedzi API

Postman pokazuje odpowiedź w różnych formatach:

Zakładki Response:

• Pretty: Sformatowany JSON (najczytelniejszy)
• Raw: Surowa odpowiedź jak przyszła z serwera
• Preview: Jak wyglądałaby strona w przeglądarce

Przydatne features dla początkujących

Environment Variables

Zamiast przepisywać cały URL, możesz użyć zmiennych:

1. Kliknij gear icon → „Manage Environments”
2. Add Environment: „Development”
3. Dodaj zmienną:
   • Variable: api_url
   • Value: https://jsonplaceholder.typicode.com
4. W URL użyj: {{api_url}}/users

History wszystkich żądań

Postman automatycznie zapisuje wszystkie wysłane żądania w History. Znajdziesz je w lewym sidebar. Super przydatne gdy chcesz powtórzyć jakiś test.

Przydatne zasoby:

• JSONPlaceholder – darmowe API do testów
• HTTP Status Codes reference
• Postman Documentation

Jakiej metody używałeś do testowania API przed poznaniem Postman? Które funkcje wydają ci się najbardziej przydatne?