Czym jest API REST?

REST API to styl architektoniczny, a nie standard, do budowania systemów rozproszonych. Opiera się na zasadach takich jak bezstanowość, architektura klient-serwer oraz użycie standardowych metod HTTP (GET, POST, PUT, DELETE, PATCH) do operacji na zasobach.

Kluczowe zasady REST:

• Bezstanowość (stateless): Serwer nie przechowuje informacji o stanie klienta między żądaniami. Każde żądanie zawiera wszystkie niezbędne informacje do jego obsługi.
• Klient-serwer: Wyraźny podział na klienta i serwer. Każdy może się rozwijać niezależnie.
• Cache'owalność: Odpowiedzi mogą być oznaczone jako cache'owalne lub nie, co poprawia wydajność.
• System warstwowy: Klient nie może się dowiedzieć, czy jest połączony bezpośrednio z serwerem, czy przez warstwy pośrednie.
• Ujednolicony interfejs: Ustandaryzowane sposoby interakcji z zasobami. Zawiera:
  • Identyfikację zasobów (URI)
  • Manipulację zasobami przez reprezentacje
  • Samoopisujące się wiadomości
  • Hypermedia jako silnik stanu aplikacji (HATEOAS) - stan aplikacji jest zarządzany przez hiperłącza.

Przykład użycia standardowych metod HTTP:

Metoda HTTP	Działanie na zasobie (np. /users)	Opis
GET	/users lub /users/{id}	Pobranie listy użytkowników lub konkretnego użytkownika.
POST	/users	Utworzenie nowego użytkownika.
PUT	/users/{id}	Pełna aktualizacja danych użytkownika po jego ID.
PATCH	/users/{id}	Częściowa aktualizacja danych użytkownika po jego ID.
DELETE	/users/{id}	Usunięcie użytkownika po jego ID.

REST API jest używane do komunikacji między różnymi systemami i aplikacjami, na przykład między frontendem a backendem.