APIkerroksen

API-kerros on arkkitehtoninen kerros, joka tarjoaa ohjelmointirajapintoja (APIt) sekä sisäisille että ulkoisille kuluttajille. Se sijaitsee tyypillisesti käyttöliittymä- tai esitystason sekä liiketoimintalogiikan sekä datankerrosten välissä. Sen keskeinen tehtävä on eristää asiakkaan koodi taustapalvelujen toteutuksesta sekä määritellä vakaat sopimukset pyyntöjen ja vastausten välillä.

API-kerros määrittelee rajapintojen rakenteen sekä käytännöt kuten autentikoinnin, valtuutuksen, virheenkäsittelyn ja versionoinnin. Sille voidaan valita erilaisia viestintäkeinoja, joista yleisimpiä ovat REST-, GraphQL- ja gRPC-rajapinnat. Hyvin suunniteltu kerros on kontraktiivinen, itsenäinen ja hyvin dokumentoitu (esim. OpenAPI/Swagger).

Laadullisia ominaisuuksia ovat myös turvallisuus, suorituskyky, caching, rate limiting sekä monitorointi. Lisäksi kerros tukee hallittua kehitys- ja release-sykliä sekä muutoshistoriaa, jotta taustapalveluissa tapahtuvat muutokset eivät riko ulkoisia sopimuksia.

Rooli ja toteutus voivat vaihdella arkkitehtuurin mukaan. API-kerros voidaan toteuttaa osana API-hakemistoa tai yhdessä API-gatewayn kanssa, joka hoitaa reitityksen, todennuksen ja rajoitukset. API-kerroksen tavoitteena on tarjota johdonmukainen, turvallinen ja helposti versiopäivitetty tapa käyttää sovelluksen toiminnallisuuksia.

Esimerkkejä ovat verkkokaupan tuotetiedot, maksutapahtumien rajapinta sekä kumppanityintegraatiot.