Perehdytään tarkemmin siihen, mitä REST API on ja miten se toimii, sillä olemme rakentamassa sellaista. Näiden peruskäsitteiden ymmärtäminen luo vankan pohjan loppuprojektille.

Suunnitelma

• Mikä on REST API?
• RESTin keskeiset periaatteet;
• Miten REST API:t toimivat.

Mikä on REST API?

REST eli Representational State Transfer on arkkitehtuurityyli verkkosovellusten suunnitteluun. REST API:t ovat joukko sääntöjä verkkopalveluiden luomiseen ja käyttöön, mahdollistaen sujuvan tiedonvaihdon ja toimintojen toteuttamisen ohjelmistojärjestelmien välillä.

RESTin keskeiset periaatteet

REST-rajapintojen ymmärtämiseksi on tärkeää muistaa seuraavat ydinasioita:

• Tilattomuus: Jokainen asiakkaan ja palvelimen välinen vuorovaikutus on itsenäinen. Kaikki tarvittavat tiedot tulee sisällyttää itse pyyntöön;
• Resurssikeskeisyys: REST käsittelee kaikkea resursseina, ja jokainen resurssi tunnistetaan yksilöllisellä URI-tunnisteella (Uniform Resource Identifier). Resurssit ovat vuorovaikutuksessa standardien HTTP-metodien, kuten GET, POST, PUT ja DELETE, avulla;
• Esitysmuoto: REST-resursseilla voi olla useita esitysmuotoja, kuten JSON tai XML. Tämä joustavuus mahdollistaa asiakkaan valita haluamansa tiedonsiirtomuodon.

REST-rajapintojen toiminta

Seuraavaksi tarkastellaan, miten REST-rajapinnat toimivat. Prosessi koostuu useista keskeisistä vaiheista:

1. Pyyntö: Asiakas lähettää pyynnön, joka sisältää kaikki tarvittavat tiedot. Näihin kuuluvat HTTP-metodi, URI sekä tarvittavat parametrit tai data;
2. Resurssi: API käsittelee pyynnön resurssin yksilöllisen URI-tunnisteen perusteella. Tämä URI toimii pyydetyn resurssin osoitteena;
3. HTTP-metodit: Standardoidut HTTP-metodit määrittävät suoritettavan toimenpiteen. Esimerkiksi GET hakee tietoa, POST luo uuden resurssin, PUT päivittää ja DELETE poistaa;
4. Vastaus: Kun pyyntö on käsitelty, palvelin palauttaa vastauksen valitussa esitysmuodossa, yleensä JSON- tai XML-muodossa. Vastaus sisältää pyydetyt tiedot tai vahvistuksen suoritetusta toimenpiteestä;
5. Tilattomuus: REST-vuorovaikutukset ovat tilattomia, eli istuntotietoa ei tallenneta pyyntöjen välillä. Jokainen pyyntö on itsenäinen ja omavarainen.