Sobes.tech
Junior — Middle

Vysvetlite princípy a hlavnú ideológiu RESTful API

sobes.tech AI

Odpoveď od AI

RESTful API je architektonický štýl na vytváranie webových služieb založený na princípoch REST (Transfer of Representational State). Hlavné myšlienky:

  • Zdroje: Všetko, s čím API pracuje, je prezentované ako zdroje (napríklad používatelia, produkty), ktoré sú identifikované jedinečnými URI.

  • HTTP metódy: Na interakciu so zdrojmi sa používajú štandardné HTTP metódy:

    • GET — získať údaje o zdroji;
    • POST — vytvoriť nový zdroj;
    • PUT — aktualizovať zdroj;
    • DELETE — odstrániť zdroj.
  • Stavové kódy: Odpovede servera obsahujú HTTP stavové kódy, ktoré informujú o výsledku operácie (napríklad 200 OK, 404 Nenájdené).

  • Bezstavovosť (stateless): Každá požiadavka od klienta na server musí obsahovať všetky potrebné informácie, server neukladá stav medzi požiadavkami.

  • Cache: Odpovede môžu byť cache-ované na zvýšenie výkonu.

  • Jednotné rozhranie: Uľahčuje interakciu a pochopenie API.

Príklad požiadavky na RESTful API na získanie zoznamu používateľov:

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

Odpoveď:

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

Takto RESTful API zabezpečuje jednoduchú, zrozumiteľnú a štandardizovanú komunikáciu medzi klientom a serverom.