Mis on REST API?

REST API on arhitektuuristiil jaotatud süsteemide ehitamiseks. RESTi põhiprintsiibid:

Statelessness: Iga klienti päring serverile peab sisaldama kogu vajalikku teavet töötlemiseks. Server ei hoia kliendi olekut päringute vahel.
Client-Server: Selge vastutuse jaotus kliendi ja serveri vahel. Klient saadab päringud, server töötleb neid.
Cacheable: Server peab näitama, kas vastuseid võib klient või vahendaja vahemällu salvestada.
Layered System: Klient ei pea otse suhtlema lõppserveriga; ta võib suhelda vahesüsteemide kaudu (proksi, koormuse jaotaja).
Uniform Interface: Ühtne ja standardiseeritud viis kliendi ja serveri vahel suhtlemiseks. See põhimõte hõlmab:
- Identification of Resources: Ressursid (andmed) identifitseeritakse URL-i kaudu.
- Manipulation of Resources Through Representations: Klient suhtleb ressurssidega, saades nende esitlusi (nt JSON, XML) ja saates uusi esitlusi muutmiseks.
- Self-descriptive Messages: Iga sõnum sisaldab piisavalt teavet, et mõista, kuidas seda töödelda.
- HATEOAS (Hypertext As The Engine Of Application State): Ressurssidel peavad olema lingid (hüperlingid) seotud ressurssidele ja saadaolevatele tegevustele.

REST API kasutab tavaliselt standardseid HTTP meetodeid ressursside operatsioonide tegemiseks:

GET: Ressursi või ressursside kogumi saamine.
POST: Uue ressursi loomine.
PUT: Olemasoleva ressursi täielik uuendamine.
PATCH: Olemasoleva ressursi osaline uuendamine.
DELETE: Ressursi kustutamine.

Näide JSON-ressursi esitlusest:

{
  "id": 1, // Tuvastaja
  "name": "Resource Name", // Ressursi nimi
  "description": "Detailed description of the resource." // Ressursi kirjeldus
}

REST API testimine hõlmab:

Funktsionaalsuse kontrolli (vastuste õigsus päringutele)
vigade töötlemist
jõudlust
turvalisust
dokumentatsiooni vastavust.