sovellusliittymää

Sovellusliittymä (API, Application Programming Interface) on ohjelmiston rajapinta, jonka kautta eri ohjelmistot voivat kommunikoida toistensa kanssa. API määrittelee, miten pyyntöjä tehdään, millaista dataa voi pyytää ja millaisia vastauksia palvelin palauttaa. Rajapinta voi olla julkinen tai suljettu ja se tarjoaa ohjelmallisen tavan käyttää kyseisen palvelun toimintoja ilman, että toteutusta tarvitsee tietää.

Sovellusliittymät voidaan jakaa erilaisten käyttötapojen mukaan; yleisiä tyyppejä ovat REST-, SOAP-, GraphQL- ja gRPC-API:t. Web-API:t käyttävät usein HTTP- tai HTTPS-protokollaa. Suositut tiedonmuodot ovat JSON ja XML; GraphQLissa kyselyt määrittelevät tarkasti tarvittavan datan.

Käyttöprosessi alkaa asiakkaan tekemällä pyynnöllä, joka osoittaa API:n päätepisteen (endpoint) ja sisältää pyynnön tyypin (esim. GET, POST), otsikot ja mahdollisen runko-osan. Palvelin palauttaa tilakoodin sekä vastauksen, joka sisältää pyydetyn datan tai virheellisen tilanteen viestin. Yleisimmät tilakoodit ovat 200 (OK), 400 (Bad Request), 401/403 (Unauthorized/Forbidden), 404 (Not Found), 500 (Internal Server Error).

Käyttötarkoituksia ovat ulkoisten toimintojen hyödyntäminen, kolmansien osapuolien datan ja palveluiden integrointi sekä mobiili- tai verkkosovellusten toiminnan laajentaminen. API:t mahdollistavat modulaarisuuden, uudelleenkäytön ja nopeamman kehityksen, mutta ne vaativat hallittua julkaisua, dokumentaatiota, versioningia sekä turvallisuuskäytäntöjä.