Mis on REST API?

REST API on arhitektuuristiil, mitte standard, mis on mõeldud hajutatud süsteemide ehitamiseks. See põhineb põhimõtetel nagu statelessness, klient-server arhitektuur ja standardsete HTTP meetodite (GET, POST, PUT, DELETE, PATCH) kasutamine ressursside operatsioonideks.

RESTi põhiprintsiibid:

• Stateless (olekuta): Server ei salvesta teavet kliendi oleku kohta vahepealsete päringute vahel. Iga päring sisaldab kogu vajalikku teavet.
• Client-Server (klient-server): Selge jaotus kliendi ja serveri vahel. Igaüks võib areneda sõltumatult.
• Cacheable (vahemälustatav): Vastuseid saab märkida vahemälustatavateks või mitte, mis parandab jõudlust.
• Layered System (kihiline süsteem): Klient ei tea, kas ta on otse ühenduses serveriga või vaheruumide kaudu.
• Uniform Interface (ühtne liides): Standardiseeritud viisid ressurssidega suhtlemiseks. Sisaldab:
  • Ressursside identifitseerimine (URI)
  • Ressursside manipuleerimine esitluste kaudu (teave ressursi kohta edastatakse esitluste kaudu)
  • Enese kirjeldavad sõnumid (iga sõnum sisaldab piisavalt teavet töötlemiseks)
  • Hypermedia kui rakenduse oleku mootor (HATEOAS) - rakenduse olekut juhitakse hüperlinkide kaudu.

Näide standardsete HTTP meetodite kasutamisest:

HTTP meetod	Tegevus ressursiga (nt /users)	Kirjeldus
GET	/users või /users/{id}	Kasutajate nimekirja või konkreetse kasutaja saamine.
POST	/users	Uue kasutaja loomine.
PUT	/users/{id}	Kogu kasutaja andmete uuendamine ID järgi.
PATCH	/users/{id}	Osaline kasutaja andmete uuendamine ID järgi.
DELETE	/users/{id}	Kasutaja kustutamine ID järgi.

REST API-d kasutatakse erinevate süsteemide ja rakenduste vaheliseks suhtlemiseks, näiteks frontend ja backend vahel.