RESTtyyppisessä

RESTtyyppinen API on verkkopalveluiden suunnittelutapa, joka noudattaa Representational State Transfer -periaatteita. Periaatteiden mukaan palvelu koostuu resursseista, joilla on yksiselitteinen URI. Toiminta resurssien kanssa tapahtuu HTTP-verbien avulla (GET, POST, PUT, PATCH, DELETE), mikä antaa yhdenmukaisen tavan hakea, luoda, päivittää tai poistaa tiloja.

Keskeiset periaatteet ovat tilattomuus (stateless), jolloin jokainen pyyntö sisältää kaiken tarvittavan, sekä client-server-rakenne, joka eriyttää käyttöliittymän (asiakas) palvelinpuolen logiikasta. Välimuistitus (cacheability) parantaa suorituskykyä, ja yhtenäinen käyttörajapinta sekä kerrosten mukainen arkkitehtuuri helpottavat ylläpitoa ja skaalautuvuutta. Maailmalle tyypillisiä lisäperiaatteita ovat resurssien representaatiot ja mahdollinen valintaiko Larela, sekä halutessa koodi määräysten kautta (code on demand) – nämä ovat kuitenkin vaihtoehtoisia ominaisuuksia, ei välttämättömiä.

Resurssien representaatioina käytetään usein JSON tai XML, ja sisällön neuvottelu (content negotiation) toteutetaan Accept- ja Content-Type -otsikoiden avulla. RESTtyyppisessä toteutuksessa resurssin tila toimitetaan asiakkaalle yleensä representaation muodossa, jolloin muutos tapahtuu siirtämällä tilaa kuvaava data.

Hypermedia (HATEOAS) on osa periaatteista: vastauksissa voidaan tarjota linkkejä seuraaviin mahdollisiin toimintoihin, jolloin clientin ei tarvitse etsiä ulkoisia ohjeita. Tämä mahdollistaa tarkan tilan ohjauksen REST-tyylisessä ympäristössä.

RESTtyyppinen suunnittelu soveltuu hyvin julkisten API:iden, mikropalveluarkkitehtuurin ja resurssipohjaisten tietojen jakamisen tarpeisiin. Haasteina voivat olla monimutkaiset resurssisuhteet, ennusteeton data-ylikäytön riski sekä HATEOAS-toteutuksen suunnittelupaine.