Sobes.tech
Junior — Middle

Selgitage RESTful API põhimõtteid ja peamist ideoloogiat

sobes.tech AI

Vastus AI-lt

RESTful API on arhitektuuristiil, mis on mõeldud veebiteenuste loomisele, põhinedes REST (Representational State Transfer) põhimõtetel. Peamised ideed:

  • Resursid: Kõik, millega API tegeleb, esitatakse ressurssidena (näiteks kasutajad, tooted), mida identifitseeritakse unikaalsete URI-dega.

  • HTTP meetodid: Ressurssidega suhtlemiseks kasutatakse standardseid HTTP meetodeid:

    • GET — saada ressursi andmeid;
    • POST — luua uus ressurss;
    • PUT — uuendada ressurssi;
    • DELETE — kustutada ressurss.
  • Staatuskoodid: Serveri vastused sisaldavad HTTP staatuskoode, mis teavitavad operatsiooni tulemusest (näiteks 200 OK, 404 Mitte leitud).

  • Stateless: Iga kliendi päring serverile peab sisaldama kõiki vajalikke andmeid, server ei hoia olekut vahepeal.

  • Puhverdamine: Vastuseid saab vahemällu salvestada, et parandada jõudlust.

  • Ühtne liides: Lihtsustab API-ga suhtlemist ja mõistmist.

Näide RESTful API päringust kasutajate nimekirja saamiseks:

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

Vastus:

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

Sellisel viisil tagab RESTful API lihtsa, arusaadava ja standardiseeritud suhtluse kliendi ja serveri vahel.