REST API to interfejs oparty na stylu architektonicznym REST, w którym zasoby identyfikowane są adresami URL, a operacje wykonuje się metodami HTTP: GET, POST, PUT, PATCH i DELETE. Dane są zwykle przesyłane w formacie JSON.
Jak działa REST API?
Klient wysyła żądanie, np. GET /uzytkownicy/5, a serwer zwraca reprezentację zasobu i kod odpowiedzi. Każde żądanie jest niezależne i nie zależy od poprzednich (bezstanowość).
Jakie są zasady REST?
- zasoby mają przewidywalne adresy,
- metody HTTP odpowiadają operacjom,
- serwer nie przechowuje stanu sesji klienta,
- odpowiedzi używają właściwych kodów statusu.
REST a GraphQL
REST udostępnia wiele endpointów zwracających stałe struktury, a GraphQL jeden endpoint, w którym klient sam wybiera pola. REST jest prostszy i łatwiej go buforować.
Zasoby identyfikuje się adresami, np. /artykuly/12, a operacje wybiera metodą HTTP. Odpowiedzi zwykle mają format JSON i właściwy kod statusu.
Wywołanie adresu niedozwoloną metodą HTTP serwer odrzuca, zwracając błąd 405 Method Not Allowed.
Zobacz w praktyce
Błąd 405 (Method Not Allowed) - co oznacza i jak go naprawić? 
Headless CMS - kiedy warto porzucić monolityczny CMS 
Błąd 400 (Bad Request) - co oznacza i jak go naprawić?