Jakie są zasady jednolitego interfejsu?

Zasady jednolitego interfejsu (znane również jako zasady projektowania RESTful API, choć mają zastosowanie również do innych rozproszonych systemów):

1. Identyfikacja zasobów: Każda część informacji, którą można adresować, powinna mieć unikalny identyfikator. Klient wchodzi w interakcję z zasobami, używając tych identyfikatorów.
2. Manipulacja zasobami przez reprezentacje: Klient otrzymuje reprezentację zasobu (np. w formacie JSON lub XML) i może zmieniać stan zasobu, wysyłając zmodyfikowaną reprezentację z powrotem do serwera.
3. Komunikaty samoopisujące: Każda wiadomość między klientem a serwerem powinna zawierać wystarczająco informacji do jej pełnej interpretacji. Klient nie powinien polegać na zewnętrznych informacjach ani stanie sesji na serwerze.
4. Hipermedia jako silnik stanu aplikacji (HATEOAS - Hypermedia As The Engine Of Application State): Serwer powinien dostarczać hiperłącza (linki) w odpowiedziach, które wskazują na kolejne możliwe działania lub powiązane zasoby. Klient porusza się po aplikacji, podążając za tymi linkami, a nie polegając na wcześniej ustalonych URL lub logice.
5. Architektura klient-serwer: Jasny podział obowiązków między klientem (odpowiedzialnym za interfejs użytkownika i inicjowanie żądań) a serwerem (odpowiedzialnym za przechowywanie danych i obsługę żądań). Taki podział poprawia skalowalność i przenośność części klienta.
6. Bezstanowość (Stateless): Każde żądanie od klienta do serwera powinno zawierać wszystkie niezbędne informacje do jego zrozumienia i obsługi. Serwer nie przechowuje informacji o stanie sesji klienta między żądaniami. To zwiększa skalowalność i odporność na awarie.

Przestrzeganie tych zasad przyczynia się do tworzenia skalowalnych, elastycznych i łatwych w utrzymaniu systemów rozproszonych.