Sobes.tech
Junior — Middle

Jak określić, czy API spełnia zasady architektury RESTful?

sobes.tech AI

Odpowiedź od AI

API RESTful spełnia zasady REST, jeśli spełnione są następujące kluczowe kryteria:

  • Poprawne użycie metod HTTP: GET do pobierania danych, POST do tworzenia, PUT/PATCH do aktualizacji, DELETE do usuwania.
  • Identyfikacja zasobów przez URI: każdy zasób ma unikalny i zrozumiały URL.
  • Brak stanu na serwerze (stateless): każde żądanie zawiera wszystkie niezbędne informacje, serwer nie przechowuje stanu klienta.
  • Użycie standardowych kodów odpowiedzi HTTP: np. 200 OK, 404 Not Found, 201 Created.
  • Wsparcie dla różnych formatów reprezentacji (np. JSON, XML) przez nagłówki Accept/Content-Type.

Można to zweryfikować, analizując API pod kątem zgodności z tymi zasadami i poprawnego użycia HTTP.


Przykład:

GET /users/123 HTTP/1.1
Host: example.com
Accept: application/json

HTTP/1.1 200 OK
Content-Type: application/json

{"id":123, "name":"Ivan"}