Sobes.tech
Junior — Middle

Wyjaśnij zasady i główną ideologię API RESTful

sobes.tech AI

Odpowiedź od AI

API RESTful to styl architektoniczny służący do tworzenia usług internetowych, oparty na zasadach REST (Transfer Stanu Representacyjnego). Główne idee:

  • Zasoby: Wszystko, z czym pracuje API, jest przedstawione jako zasoby (np. użytkownicy, produkty), które są identyfikowane przez unikalne URI.

  • Metody HTTP: Do interakcji z zasobami używa się standardowych metod HTTP:

    • GET — pobierz dane zasobu;
    • POST — utwórz nowy zasób;
    • PUT — zaktualizuj zasób;
    • DELETE — usuń zasób.
  • Kody statusu: Odpowiedzi serwera zawierają kody statusu HTTP, które informują o wyniku operacji (np. 200 OK, 404 Nie znaleziono).

  • Bez stanu (stateless): Każde żądanie od klienta do serwera musi zawierać wszystkie niezbędne informacje do obsługi, serwer nie przechowuje stanu między żądaniami.

  • Buforowanie: Odpowiedzi mogą być buforowane w celu zwiększenia wydajności.

  • Jednolity interfejs: Ułatwia interakcję i zrozumienie API.

Przykład żądania do RESTful API w celu uzyskania listy użytkowników:

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

Odpowiedź:

[
  {"id": 1, "name": "Иван"},
  {"id": 2, "name": "Мария"}
]

W ten sposób API RESTful zapewnia prostą, zrozumiałą i standaryzowaną interakcję między klientem a serwerem.