Lekcja 4 / porządek pracy

Kolekcje i zmienne: koniec z ręcznym przepisywaniem URL-i

Masz już kilka requestów. Jeśli każdy żyje osobno, szybko robi się bałagan. Kolekcja i environment zamieniają przypadkowe klikanie w mały, powtarzalny proces QA.

Problem: ten sam adres w dziesięciu miejscach

Wyobraź sobie, że testujesz API na środowisku testowym, a jutro masz odpalić te same requesty na stagingu. Jeśli wszędzie wkleiłeś pełny URL, ręczna podmiana to proszenie się o błąd.

Bez zmiennych	Ze zmienną	Co zyskujesz
`https://api.test.example.com/users`	`{{baseUrl}}/users`	Jedna zmiana środowiska
`https://api.test.example.com/orders`	`{{baseUrl}}/orders`	Mniej literówek
`https://api.test.example.com/payments`	`{{baseUrl}}/payments`	Ten sam flow na różnych API

Jak to ustawić

Utwórz kolekcję API Smoke - sklep.
Dodaj requesty: health, products, create cart.
Utwórz environment Test.
Dodaj zmienną baseUrl z wartością https://jsonplaceholder.typicode.com.
W requestach użyj {{baseUrl}} zamiast pełnego adresu.

Postman: panel Environments i przycisk Create — Environment tworzysz z lewego panelu. Potem wybierasz aktywne środowisko z dropdownu nad requestem.

GET {{baseUrl}}/users/1
GET {{baseUrl}}/posts?userId=1
POST {{baseUrl}}/posts

Co warto zapamiętać

Kolekcja
Folder pracy. Trzyma requesty, opis flow, testy i ustawienia, które mają iść razem.

Environment
Zestaw zmiennych dla konkretnego środowiska: test, staging, lokalnie, demo.

Zmienna nie jest sztuczką dla wygody. To zabezpieczenie przed chaosem. Dzięki niej widzisz, które wartości są częścią scenariusza, a które są konfiguracją środowiska.

Ćwiczenie

Zrób kolekcję z dwoma requestami: GET {{baseUrl}}/users/1 i GET {{baseUrl}}/posts?userId=1. Potem zmień baseUrl w jednym miejscu i sprawdź, czy requesty nadal budują się poprawnie.

Mini-zadanie

Dodaj zmienną userId i użyj jej w URL-u: {{baseUrl}}/posts?userId={{userId}}.

Większa praktyka

Opisz własnymi słowami różnicę między zmienną środowiskową a wartością wpisaną na stałe w request. Podaj jeden przykład błędu, którego zmienna pomaga uniknąć.

Quiz

Po co tworzyć kolekcję?

Żeby trzymać requesty jednego procesu razem i móc je potem uruchamiać oraz utrzymywać jako całość.

Co oznacza {{baseUrl}}?

Odwołanie do zmiennej Postmana. Jej wartość pochodzi z wybranego environmentu albo innego zakresu zmiennych.

Dlaczego nie warto wklejać tokenów i URL-i wszędzie ręcznie?

Bo łatwo zrobić literówkę, zapomnieć o podmianie środowiska albo przypadkiem zostawić sekret w złym miejscu.

Co dalej?

Skoro mamy zmienne, możemy bezpieczniej podejść do tokenów. W następnej lekcji zobaczysz, jak API sprawdza, czy masz prawo wykonać request.