RESTrajapinnat

RESTrajapinnat ovat REST-tyylisiä verkkopalvelujen käyttöliittymiä, jotka mahdollistavat ohjelmistojen välisen vuorovaikutuksen ja resurssien hallinnan HTTP:n avulla. REST-rajapinnat perustuvat REST-arkkitehtuurityyliin, jonka määritteli Roy Fielding vuonna 2000. Ne ovat suosittuja, koska ne ovat yksinkertaisia, skaalautuvia ja helposti integroitavissa eri järjestelmiin.

Keskeisiä periaatteita ovat resurssien tunnistaminen uniikeilla URI-osoitteilla, resurssien esitykset JSON- tai XML-muodossa sekä HTTP-menetelmien käyttö (GET, POST, PUT, PATCH, DELETE). Rajapinnat ovat tilattomia (stateless), mahdollistavat välimuistin käytön ja voivat rakentua kerrosten päälle. Käyttöliittymä on suunniteltu siten, että samaa protokollaa ja käskyjä voidaan käyttää monissa sovelluksissa.

Suunnittelussa huomioidaan resurssimalli, versionointi, sisältöneuvottelu ja usein hypermedia-tuki (esimerkiksi HAL). Tavallisia operaatioita ovat GET resurssin lukemiseen, POST uuden resurssin luomiseen, PUT/PATCH päivitykseen ja DELETE poistamiseen. Tilakoodit ohjaavat vastauksia (esim. 200, 201, 204, 400, 404, 500).

Turvallisuus ja suorituskyky: käytetään TLS-salausta, autentikointia API-avaimilla tai OAuth 2.0:lla, sekä rajoituksia (rate limiting) ja syötteiden validointia.

Dokumentaatio ja ylläpito: OpenAPI/Swagger, testaus- työkalut sekä selkeä versionointi ja deprekaatio sekä monitorointi.

REST-rajapinnat toimivat hyvin mikropalvelu-, mobiili- ja web-sovelluksissa, mutta niiden suunnittelussa on huomioitava tiedon hakemisen liiallisuus sekä evoluution hallinta.