APIrajapintaa
API-rajapinta (Application Programming Interface) on ohjelmistojen välinen sopimus, jonka kautta osa ohjelmistoa tarjoaa toimintoja ja dataa muille ohjelmistoille. Rajapinnan avulla kehittäjät voivat käyttää valmiita palveluita ilman, että niiden toteutusta tarvitsee tuntea. API-rajapintoja voidaan tarjota julkisesti, kumppaneille tai sisäisesti organisaatiossa.
Tyypit ja protokollat: Yleisimmät rajapintatyypit ovat REST, GraphQL ja SOAP, sekä gRPC joissakin käyttötapauksissa. Suurin osa
Autentikointi, valvonta ja turvallisuus: Yleisiä suojauksia ovat API-avaimet, OAuth 2.0 -käyttöoikeudet ja JWT-tunnisteet. Rajapinnat voivat käyttää
Versiointi ja dokumentaatio: Rajapinnat versioidaan, jotta muutokset eivät riko olemassa olevia sovelluksia. Dokumentaatio (esim. OpenAPI/Swagger, RAML)
Suunnittelu ja käytännöt: Hyviä käytäntöjä ovat stateless-arkkitehtuuri, idempotenssi, sekä mahdollisuus seuraa ja palauttaa tapahtumaketjuja (esim. HATEOAS).
Käyttötapaukset ja hyödyt: API-rajapintoja käytetään järjestelmien integraatioihin, mobiilisovelluksiin ja kolmansien osapuolien kehittäjien laajennuksiin. Ne mahdollistavat toiminnallisuuden