APItyypit

APItyypit ovat ohjelmointirajapintojen (APIt) erilaisia jakelu- ja käyttötapoja, joita organisaatiot tarjoavat kolmansille osapuolille tai omalle järjestelmäkunnalleen. Ne kuvaavat, kuka saa käyttää rajapintaa, millä tavoin ja millaisia resursseja rajapinnan kautta tarjotaan. API-rajapinnat voivat olla julkisia, kumppanille tarkoitettuja tai sisäisiä.

Julkiset (public/open) API:t ovat avoimesti käytettävissä laajalle kehittäjäyhteisölle ja usein tukevat ekosysteemien laajentamista sekä ulkoisten sovellusten integraatioita. Kumppani-API:t ovat rajoitetumpia ja niitä käyttää valittu yhteistyökumppaniyhteisö. Sisäiset (private) tai yrityksen sisäiset API:t on tarkoitettu käytettäväksi vain organisaation sisällä. Näiden erien avulla hallitaan käyttöoikeuksia, tietoturvaa ja hallintaa.

Teknologisesti yleisiä api-tyyppejä ovat REST, SOAP, GraphQL ja gRPC. REST perustuu HTTP:iin ja resurssien tilattomaan käsittelyyn, käytäntöinä usein JSON tai XML. SOAP on XML-pohjainen protokolla, jolla on tiukat sopimusmallit WSDL:n kautta. GraphQL antaa asiakaspuoleiselle koodille mahdollisuuden pyytää juuri tarvitut tiedot yhdellä hakulla. gRPC on tehokas RPC-ratkaisu, joka hyödyntää protobuf-viestejä ja tukee striimausta. Lisäksi on RPC-pohjaisia ratkaisuja kuten JSON-RPC ja XML-RPC. Event-driven mallissa käytetään Webhookeja tai pub/sub -malleja, joissa palvelut reagoivat tapahtumiin.

Turvallisuus, hallinta ja elinkaari ovat tärkeitä: käytetään API-avaimia, OAuth tai JWT -todennusta, kiinnitetään huomiota rate limitingiin ja versiointiin. API-management-työkalut sekä portaali tarjoavat dokumentaation, testausympäristöt ja versioiden hallinnan.