Lekcja 3 / request z danymi
Body i metody: POST, PUT, PATCH, DELETE bez chaosu
Do tej pory tylko czytasz dane. Teraz przychodzi typowe zadanie QA: sprawdzić, czy API poprawnie przyjmuje dane formularza. Tu pojawia się body, czyli treść requestu.
Najpierw zobacz różnicę między metodami
Metoda HTTP mówi API, jaki typ akcji próbujesz wykonać. Nie ucz się tego jak tabelki do wykucia. Wyobraź sobie pracę z jednym zgłoszeniem albo postem.
| Metoda | Intencja | Przykład QA |
|---|---|---|
| GET | Odczytaj | Sprawdź, czy post istnieje |
| POST | Utwórz | Wyślij formularz nowego zgłoszenia |
| PUT | Podmień całość | Zastąp pełny opis profilu |
| PATCH | Zmień fragment | Zmień tylko status zgłoszenia |
| DELETE | Usuń | Usuń testowy zasób po scenariuszu |
- Przycisk metody — klikasz, żeby rozwinąć listę.
- Lista metod — każda niesie inną intencję wobec tego samego zasobu.
POST z JSON body
W Postmanie ustawiasz metodę POST, wchodzisz w Body, wybierasz raw i JSON. Body musi być poprawnym JSON-em: klucze w cudzysłowach, tekst w cudzysłowach, przecinki między polami.
- Zakładka Body — tu wpisujesz treść requestu.
- Typ raw — surowa treść zamiast formularza.
- Format JSON — Postman dopisze nagłówek
Content-Type.
POST https://jsonplaceholder.typicode.com/posts
Content-Type: application/json
{
"title": "Błąd w checkoutcie",
"body": "Koszyk nie przelicza rabatu po zmianie ilości.",
"userId": 7
}
Status 201 Created zwykle oznacza, że zasób został utworzony. W mock API wynik nie zapisuje się
naprawdę na serwerze, ale dobrze pokazuje kształt requestu i odpowiedzi.
Jak nie pomylić body z parametrami
Dobre do zawężania odczytu:
?userId=7, ?status=open.
Dobre do przesłania danych formularza, konfiguracji albo payloadu zamówienia.
W praktyce QA patrzysz nie tylko na status. Sprawdzasz, czy odpowiedź zawiera pola, które wysłałeś, i czy API nie ignoruje ważnego pola bez komunikatu.
Ćwiczenie
Wyślij POST z własnym tytułem i treścią zgłoszenia. Zapisz status, nowe id z odpowiedzi
i sprawdź, czy title w odpowiedzi jest taki sam jak w body.
Mini-zadanie
Usuń przecinek między polami JSON i zobacz, jak Postman sygnalizuje błąd składni.
Większa praktyka
Przygotuj cztery krótkie requesty w notatce: POST tworzy, PUT podmienia, PATCH zmienia fragment, DELETE usuwa. Do każdego dopisz jedno ryzyko QA.
Quiz
Kiedy używasz body?
Gdy request ma wysłać dane do API, na przykład formularz, opis zgłoszenia albo konfigurację.
Jaka jest najprostsza różnica między PUT i PATCH?
PUT zwykle oznacza pełną podmianę zasobu, PATCH częściową zmianę.
Czego uczy status 201?
Że API przyjęło request jako utworzenie zasobu. Nadal warto sprawdzić treść odpowiedzi.
Co dalej?
Znasz już requesty odczytu i requesty z body. Teraz uporządkujemy je w kolekcje i zmienne, żeby przestać ręcznie przepisywać te same adresy.