ohjelmointirajapinnoissa

Ohjelmointirajapinnoissa tarkoitetaan ohjelmistojen välistä sopimusta, jonka kautta komponentit voivat kommunikoida. Rajapinta määrittelee käytettävissä olevat toiminnot, syötteet ja palautettavat tiedot sekä odotetun käyttäytymisen. API voi olla julkinen tai suljettu ja se sovitaan osaksi ohjelmiston arkkitehtuuria.

Tyyppejä ovat web-API:t, joita tarjotaan HTTP-pyyntöjen avulla ja jotka voivat noudattaa REST-, GraphQL- tai gRPC -mallia; kirjasto-API:t, joita kirjastot tarjoavat; sekä käyttöjärjestelmän tai alustan API:t, joiden kautta sovellus käyttää järjestelmän toimintoja.

Suunnittelussa korostuvat selkeys ja vakaus: API on dokumentoitu, versionointi on linjassa ja muutokset hallitaan siirtymäaikojen avulla. Turvallisuus, suorituskyky ja käytettävyys ovat keskeisiä, ja virheenkäsittely sekä takaisin yhteensopivuus huomioidaan.

Käyttöönotossa käytetään yleisiä formaatteja kuten JSON tai XML sekä protokollia kuten HTTP(S). Turvallisuudessa käytetään menetelmiä kuten OAuth, API-avaimia tai JWT.

Esimerkkejä ovat REST-tyyppiset web-API:t kuten GitHubin API, GraphQL-API:t ja gRPC-palvelut. Käyttöjärjestelmä-API:ita ovat POSIX- ja Windows-rajapinnat. API-kehityksessä korostuvat standardien noudattaminen, yhteensopivuuden säilyttäminen ja hyvin suunnitellut virheilmoitukset.