Syvennytää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 loppuprojektillemme.

Suunnitelma

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

Mikä on REST API?

REST eli Representational State Transfer on arkkitehtoninen tyyli 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 ydinkohdat:

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

REST-rajapintojen toiminta

Tarkastellaan seuraavaksi, miten REST-rajapinnat toimivat. Prosessi sisältää useita keskeisiä vaiheita:

1. Pyyntö: Asiakas lähettää pyynnön, joka sisältää kaikki tarvittavat tiedot. Näihin kuuluvat HTTP-metodi, URI ja 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: Vakiintuneet HTTP-metodit määrittävät suoritettavan operaation tyypin. Esimerkiksi GET on tiedon hakemista varten, POST luomista, PUT päivittämistä ja DELETE poistamista varten;
4. Vastaus: Kun pyyntö on käsitelty, palvelin lähettää vastauksen valitussa esitysmuodossa, tyypillisesti JSON- tai XML-muodossa. Vastaus sisältää pyydetyn datan tai vahvistuksen suoritetusta toimenpiteestä;
5. Tilattomuus: REST-vuorovaikutukset on suunniteltu tilattomiksi, eli istuntotietoa ei tallenneta pyyntöjen välillä. Jokainen pyyntö on itsenäinen ja omavarainen.