{"id":156,"date":"2015-03-14T20:11:25","date_gmt":"2015-03-14T18:11:25","guid":{"rendered":"http:\/\/sorvipenkki.fi\/blog\/?p=156"},"modified":"2015-03-14T20:11:25","modified_gmt":"2015-03-14T18:11:25","slug":"rajapinnoista","status":"publish","type":"post","link":"http:\/\/sorvipenkki.fi\/blog\/2015\/03\/14\/rajapinnoista\/","title":{"rendered":"Rajapinnoista"},"content":{"rendered":"
\"Tsahi<\/a>
Tsahi Levent-Levi, API calls, https:\/\/www.flickr.com\/photos\/86979666@N00\/8692704103<\/figcaption><\/figure>\n

Tampereen teknillisen yliopiston Ohjelmallinen sis\u00e4ll\u00f6nhallinta -opintojaksossa tarjottiin helmikuussa vierailuluento web-ohjelmointirajapinnoista<\/a>. Luennolla puhuivat OKM:n kehitt\u00e4misp\u00e4\u00e4llikk\u00f6 Jarkko Moilanen<\/a> ja Tampereen kaupungin tietohallinnon edustaja Joonas Dukpa.<\/p>\n

Moilanen pohdiskeli ohjelmointirajapintojen (application programming interface, API)<\/a> merkityst\u00e4 tietoj\u00e4rjestelmien kehitt\u00e4misess\u00e4 ja Dukpa kertoi Tampereen kaupungin avoin data -ohjelmasta<\/a>.<\/p>\n

Moilasen mukaan suunta on se, ett\u00e4 maailmalla start-up-yrityksiss\u00e4 homma l\u00e4htee nyky\u00e4\u00e4n rajapintojen rakentamisesta. Rajapintoja ja pilviteknologiaa pidet\u00e4\u00e4n v\u00e4ltt\u00e4m\u00e4tt\u00f6min\u00e4 digitaaliselle liiketoiminnolle.<\/p>\n

Rajapinta ideana on vanha juttu: yhten\u00e4 aloituskohtana pidet\u00e4\u00e4n Roy Fieldingsin vuonna 2000 julkaisemaa v\u00e4it\u00f6skirjaa Architectural styles and the design of network-based software architecture<\/a>. K\u00e4\u00e4nnekohtana Moilanen pit\u00e4\u00e4 vuotta 2006, jolloin julkaistiin muun muassa sosiaalisen median verkkopalvelujen rajapintoja (Facebook API<\/a>, Twitter API<\/a>) ja Amazonin pilvipalveluja (Amazon S3<\/a>, Amazon EC2<\/a>). Vuonna 2007 telekommunikaatioteknologiaan erikoistunut yritys Twilio<\/a> on kiinnostava rajapintojen n\u00e4k\u00f6kulmasta, koska sen liiketoimintaidea perustuu ohjelmointirajapintojen tarjoamiseen puhelin- ja tekstiviestiliikenteen hallinnointiin.<\/p>\n

Tekninen rajapinta vain yksi osa kokonaisuutta. Kyse on ekosysteemist\u00e4, jonka muodostavat muun muassa kehitt\u00e4j\u00e4t, itse j\u00e4rjestelm\u00e4, konteksti, asiakkaat, trendit & tarpeet. Asiakkaissakin on eroa: rajapinnan asiakas eri kuin lopputuotetta k\u00e4ytt\u00e4v\u00e4 asiakas.<\/p>\n

Verkkopalvelun tekninen arkkitehtuuri on monimutkaistunut. Vuonna 2006 voitiin verkkopalvelu-ymp\u00e4rist\u00f6 kuvata kutakuinkin 3 palikalla, jotka olivat web-sovellus + taustalla oleva tietokanta (esim. SQL) + loppuk\u00e4ytt\u00e4j\u00e4. Web-sovelluksen takana oli useita rajapintoja (esimerkiksi SOAP ja JSON (esimerkiksi laskutuksessa k\u00e4ytetyt rajapinnat), screen scraping -”rajapinta”, WMS (esim. karttapalveluissa k\u00e4ytetty rajapinta), jotka osaltaan muodostavat web-sovellus-kokonaisuuden.<\/p>\n

Vuonna 2013 rajapintoja on edelleen useita + tietokanta + yrityksen\/palvelun tarjoajan ulkoinen API:en k\u00e4ytt\u00f6. Rajapintojen kautta tarjotaan palveluja ja dataa erilaisille web-sovelluksille, mobiili-sovelluksille ja Internet of Things -palveluille. Verkkopalvelujen tarjoajat ovat kaupallistaneet rajapintapuolen. Rajapintojen kautta haravoitavan datan jatkojalostuksessa Python on yksi ammattilaisten k\u00e4ytetyimmist\u00e4 ty\u00f6kaluista.<\/p>\n

SOAP<\/a>\/XML<\/a> on java-l\u00e4ht\u00f6inen, liike-el\u00e4m\u00e4n tarpeiden ehdoilla (ideointi ja m\u00e4\u00e4rittely) kehitetty rajapintaprotokolla. Kansallisen palveluv\u00e4yl\u00e4n<\/a> versio 6 tulee olemaan t\u00e4t\u00e4, mutta data muljutellaan my\u00f6s JSON<\/a>-muotoon. SOAP\/XML:n etuna ovat Moilasen mukaan monipuolisemmat vuorovaikutusmahdollisuudet kuin REST\/JSONilla.<\/p>\n

REST<\/a>\/JSON -arkkitehtuurimallin taustalla oleva ideologia edustaa standardoituun SOAP\/XML:\u00e4\u00e4n verrattuna joviaalimpaa, kehitt\u00e4j\u00e4yhteis\u00f6n pragmaattista l\u00e4hestymistapaa. Malli on javascript-l\u00e4ht\u00f6inen ja k\u00e4yt\u00f6ss\u00e4 muun muassa tavallisissa, arkip\u00e4iv\u00e4n web-sovelluksissa. Malli on keve\u00e4mpi ja vapaampi verrattuna SOAP\/XML:\u00e4\u00e4n.<\/p>\n

Nousussa on teollinen Internet alias esineiden Internet (Internet of Things<\/a>). Esineiden Internetist\u00e4 on pari mainintaa kertynyt (Online 11: mobiili tuli jo<\/a> ja ITK 2010: tulevaisuudesta<\/a>). T\u00e4ll\u00e4 puolella aktiivisia ovat muun muassa Konecranes ja Kone. Esimerkiksi teollisuusnostureissa on rajapintoja kommunikointiin muiden laitteiden\/j\u00e4rjestelmien kanssa.<\/p>\n

Nyt kun avoimen datan kanssa ollaan jo edetty jonkin verran, seuraava nouseva trendi on mahdollisesti omadata eli my data<\/a>.<\/p>\n

Ohjelmointirajapinta on tuote. Rajapintoja on erilaisia erilaisiin k\u00e4ytt\u00f6tarkoituksiin: Ns. sis\u00e4inen API on tarkoitettu palvelunrakentajan omaan k\u00e4ytt\u00f6\u00f6n tarkoitettu. Kumppani-API helpottaa yhteisty\u00f6t\u00e4, jossa vaihdetaan dataa tai rahaa yhteisty\u00f6kumppanin kanssa. Avoin-API mahdollistaa innovoinnin ja on markkinointikeino omalle yritykselle.<\/p>\n

Perusta n\u00e4iss\u00e4 rajapinnoissa on kaikissa sama. Lis\u00e4ominaisuuksilla ja rajoitteilla erotellaan rajapintoja toisistaan.<\/p>\n

K\u00e4ytett\u00e4vyydess\u00e4 tulisi ottaa huomioon my\u00f6s rajapintojen k\u00e4ytett\u00e4vyys. Ohjelmistosuunnittelussa k\u00e4ytt\u00e4j\u00e4 huomioidaan: k\u00e4ytt\u00f6liittym\u00e4 (user interface eli UI)<\/a> ja k\u00e4ytt\u00e4j\u00e4kokemus (user experience eli UX)<\/a>. Rajapintojen suunnittelussa pit\u00e4isi saada yhdeksi ulottuvuudeksi rajapintojen k\u00e4ytt\u00e4j\u00e4kokemus, APX. Onnistunut rajapintojen k\u00e4ytt\u00e4j\u00e4kokemus syntyy Moilasen mukaan siit\u00e4, ett\u00e4 esimerkiksi
\nrajapinta mahdollistaa itsepalvelun (kehitt\u00e4j\u00e4 p\u00e4\u00e4see omin avuin alkuun)
\nrajapinnan k\u00e4yt\u00f6ss\u00e4 ovat helpot, selke\u00e4t ja matalat integrointiaskeleet. TTFHW:n (time to first hello world) pit\u00e4isi olla mahdollisimman lyhyt
\ndokumentaatio l\u00f6ytyy
\ntarjolla on rajapintaa hy\u00f6dynt\u00e4vi\u00e4 esimerkkikoodeja. Esimerkiksi hackathonit<\/a> ovat mainio tilaisuus, jossa voidaan tuottaa esimerkkikoodia
\ntuki- ja palautekanava ovat tarjolla (esimerkiksi Stack exchange<\/a>, Quora<\/a>)
\nrajapinnan k\u00e4ytt\u00e4miselle on selke\u00e4 k\u00e4ytt\u00e4j\u00e4sopimus. T\u00e4m\u00e4n ei pit\u00e4isi olla ensimm\u00e4inen, koska esimerkiksi 30 sivua juristeeriaa on hyv\u00e4 tapa karkoittaa kehitt\u00e4j\u00e4t.<\/p>\n

Keskeisi\u00e4 ohjelmointirajapintojen kuvauskieli\u00e4 ovat<\/p>\n