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

Postman: lista metod HTTP z GET, POST, PUT, PATCH i DELETE — Metodę requestu zmieniasz z dropdownu obok URL-a. To tutaj wybierasz POST, PUT, PATCH albo DELETE.

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.

Postman: zakładka Body i wybór typu raw dla requestu — W zakładce Body wybierasz typ danych. Dla JSON-a najczęściej wybierasz raw, a potem format JSON.

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

Params
Dobre do zawężania odczytu: ?userId=7, ?status=open.

Body
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.