Kas saak selgitada REST arhitektuuri põhialuseid ja kuidas need rakenduvad API arendamisel?

REST (Esinduslik Seisundi Ülekanne) on arhitektuuristiil, mida kasutatakse veebiteenuste loomisel ning mis põhineb mitmetel põhimõtetel:

• Kliendi-serveri arhitektuur: klient ja server on eraldatud, mis lihtsustab arendust ja skaleerimist.
• Olekuvaba (stateless): iga kliendi ja serveri vaheline päring peab sisaldama kogu vajalikku teavet, server ei hoia olekut vahepealsete päringute vahel.
• Vahemälu kasutamine: vastuseid saab vahemällu salvestada, et parandada jõudlust.
• Ühtne liides: kasutatakse standardseid HTTP meetodeid (GET, POST, PUT, DELETE) ressurssidega töötamiseks.
• Resursside identifitseerimine URI kaudu: iga ressurss omab unikaalset aadressi.
• Mitmekihiline süsteem: arhitektuur võib koosneda mitmest kihist, näiteks proxy'd, gateway'd.

REST API arendamisel rakendatakse neid põhimõtteid järgmiselt:

• Ressursid (näiteks kasutajad, tooted) esitatakse URL-ide kaudu, näiteks /users/123.
• Kasutatakse HTTP meetodeid: GET, et saada, POST, et luua, PUT/PATCH, et uuendada, DELETE, et kustutada.
• Server ei hoia sessioone, kogu päringu töötlemiseks vajalikud andmed edastatakse selle kaudu.
• Vastused võivad sisaldada päiseid vahemällu salvestamiseks.
• Andmeformaadid on tavaliselt JSON või XML.

Näide päringust kasutaja saamiseks:

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

Vastus:

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