ohjelmointirajapinnan

Ohjelmointirajapinta (API, Application Programming Interface) on ohjelmistojen välinen rajapinta, joka määrittelee, miten komponentit voivat kommunikoida keskenään. Se kertoo, mitä toimintoja on saatavilla, millaiset syötteet ne ottavat vastaan ja millaista palautetta ne antavat. API helpottaa ohjelmistojen välistä yhteistyötä ja mahdollistaa uudelleenkäytön.

API voi olla useassa muodossa. Kirjasto- tai SDK-tasoinen API tarjoaa toiminnot suoraan koodin kautta käytettäväksi. Web-API on verkon yli käytettävä, usein HTTP-pohjainen ja palaute on rakennettu standardeille kuten JSON tai XML. Operatiivisen järjestelmän API antaa ohjelmille pääsyn käyttöjärjestelmän resursseihin, kun taas laite- tai alusta-spesifisiä API:ita käytetään laitteiden ohjaukseen.

Hyvän API:n suunnittelussa korostuvat selkeä ja kattava dokumentaatio, johdonmukainen nimeäminen, vakaus sekä versionointi. Versionointi antaa etäisyyden muutoksille ja deprekaatiolle. Turvallisuus, autentikointi ja käyttöoikeudet sekä virheenkäsittely ovat olennaisia. Käytännössä monet API:t noudattavat REST-, SOAP-, RPC-, tai GraphQL -periaatteita, ja tiedonvaihto tapahtuu yleisesti JSON- tai XML-muodossa.

API:t mahdollistavat kolmansien osapuolien integraation, palveluiden automatisoinnin ja ohjelmistojen laajentamisen ilman, että lähdekoodia tarvitsee muuttaa. Ne ovat keskeisiä nykyaikaisessa ohjelmistokehityksessä, mobiilisovelluksissa, pilvi- ja mikropalveluarkkitehtuureissa sekä IoT-sovelluksissa.

Haasteisiin kuuluvat versionhallinta, turvallisuus, riittävä dokumentaatio sekä käytön valvonta ja suorituskyvyn hallinta.