REST API

REST API (Representational State Transfer) on yleisin rajapintastandardi verkkopalveluiden väliseen viestintään. Se käyttää tavallista HTTP-protokollaa ja on suunniteltu yksinkertaiseksi, skaalautuvaksi ja helposti ymmärrettäväksi.

REST API:n perusperiaatteet

REST perustuu kuuteen arkkitehtuuriperiaatteeseen:

• Asiakas-palvelin — asiakas ja palvelin ovat erillisiä ja voivat kehittyä itsenäisesti
• Tilattomuus — jokainen pyyntö sisältää kaiken tarvittavan tiedon, palvelin ei muista aiempia pyyntöjä
• Välimuistiystävällisyys — vastaukset voidaan tallentaa välimuistiin suorituskyvyn parantamiseksi
• Yhtenäinen rajapinta — ennustettava ja johdonmukainen tapa käsitellä resursseja
• Kerroksittaisuus — järjestelmä voi koostua useista kerroksista (kuormantasaus, välimuisti)
• Valinnainen koodin lataus — palvelin voi lähettää suoritettavaa koodia asiakkaalle

HTTP-metodit REST API:ssa

REST API käyttää HTTP-protokollan metodeja eri operaatioihin:

Esimerkiksi verkkokaupan REST API voisi toimia näin:

• GET /api/tuotteet — listaa kaikki tuotteet
• GET /api/tuotteet/123 — hae tuote ID:llä 123
• POST /api/tilaukset — luo uusi tilaus

REST API käytännössä

Pk-yrityksen verkkosivustolla REST API:t ovat käytössä monessa paikassa:

• Yhteydenottolomake — lomakkeen tiedot lähetetään POST-pyynnöllä palvelimelle
• Google Maps — karttaupotus hakee karttatiedot GET-pyynnöllä
• Maksupalvelu — maksutapahtuma luodaan POST-pyynnöllä Stripe- tai Paytrail-rajapintaan
• CRM-integraatio — uusi liidi luodaan POST-pyynnöllä CRM-järjestelmään

REST API vs. GraphQL

REST API:n rinnalle on noussut GraphQL vaihtoehtoisena rajapintastandardina:

Useimmille pk-yritysten tarpeille REST API on riittävä ja yksinkertaisempi toteuttaa.

Yhteenveto

REST API on webin yleisin rajapintastandardi, joka mahdollistaa järjestelmien välisen tiedonvaihdon HTTP-protokollan avulla. Se on yksinkertainen, skaalautuva ja laajasti tuettu. Pk-yrityksen sivustolla REST API:t toimivat taustalla lomakkeiden lähettämisessä, maksujen käsittelyssä ja palveluintegraatioissa — luotettavasti ja näkymättömästi.