Web API:t

Esitetty TTY:llä vierailuluentona http://www.tut.fi/fi/tietoa-yliopistosta/uutiset-ja-tapahtumat/tapahtumat/vierailuluento-web-apit-ja-avoin-data-p086580

Transcript

1. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f API:Hack Tournee 2014 Web API:t Jarkko Moilanen API-lähettiläs Apisuomi.fi Esittäjästä: • Open source kokemusta 15+ vuotta • Yhteisömanageri 6+ vuotta • CTO kokemusta 2+ vuotta • Koodaava arkkitehti • Startup kokemusta 3+ vuotta • Virkamies 1,5 vuotta (OKM) • Jatko-opiskelija (UTA) 24.2.2015 - TTY, Tampere
2. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f API:Suomi • Perustettu 6/2014 • Alunperin ajatus tehdä API -listaus • Evankelisointia (API -lähettiläät) • API roadshow (syksy 2014) • API starter kit (http://bit.ly/apistarter) • API 101 oppaita – best practices tyyppisiä • API lounaita (Tre, Helsinki) • API Design Guide (X-Road) • Open API working group (OKF)
3. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Rajapinnat Rajapinnat yhdestä yhdestä paikasta paikasta 1) Palvelu listaa yhteisön ilmoittamat suomalaiset rajapinnat (kaupalliset ja muut) – Tietojen ilmoittaminen nyt webistä lomakkeella, jatkossa automatisoidusti 2) API:t kategorioissa ja tageilla merkattuina – Lisäksi lyhyt kuvaus, onko avointa lähdekoodia, tuetut datatyypit, linkki dokumentaatioon, maksullisuustieto ja paljon muuta. 3) Mahdollisuus julkiseen palautteeseen – Rajapintojen kommentointi ja arvotus (*****)
4. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Yhteisön palvelijat ja Yhteisön palvelijat ja jatkuvuus jatkuvuus • Yhteisön polttoaineen muodostaa vapaaehtoiset API -lähettiläät, jotka: • levittävät tietoa erilaisista rajapinnoista, hyvistä rajapintakäytänteistä, • aktivoivat ja inspiroivat kehittäjiä käyttämään rajapintoja, • järjestävät API -tapahtumia eri puolilla Suomea, • edesauttavat uusien (avoimien) rajapintojen luomista • http://apisuomi.f/suomen-api-lahettilaat/ • Tällä hetkellä 6 rohkeaa API -samuraita • Liity mukaan!
5. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Kyse on ekosysteemistä Kyse on ekosysteemistä Konteksti Asiakas Trendit & tarpeet Arvoketju APX Tuote Hallinta API API Asiakas Sovellus Palvelu Järjestelmä Kehittäjä Kehittäjä
6. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Yleensä selitetään toimitusjohtajalle näin... Yleensä selitetään toimitusjohtajalle näin... Prosessoi (REST) Dataa (JSON) Pyyntö (Javascript) API on määritelmä, jonka mukaan eri ohjelmat voivat tehdä pyyntöjä ja vaihtaa tietoja eli keskustella keskenään (client) PULL PUSH
7. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Mutta todellisuudessa 2006... Mutta todellisuudessa 2006... Laskutus API Asiakas tiedot API Kartta API Web sovellus XML (SOAP) JSON “RAAVITTUA” SQL tms Laskutus API WMS Yleensä selitetään keskijohdolle näin...
8. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f 2013 > api economy 2013 > api economy Laskutus API Asiakas tiedot API Toimitus API Minun palveluni API SQL tms Oma web sovellus Web sovellus Mobiili sovellus 1 Mobiili sovellus 2 € € Yrityksen sisäinen API:en käyttö € Yrityksen ulkoinen API:en käyttö SOAP REST “RAAVITTUA” REST REST REST REST IoT
9. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f ...vanha juttu • 2000 – Salesforce.com (CRM), eBay • 2003 – Del.icio.us API • 2004 – Flickr launched API • …. Roy Fieldings: Architectural Styles and the Design of Network-based Software Architectures (2000) • 2006 (käännekohta) – Facebook API, Twitter API, Google Maps API, Amazon S3, Amazon EC2 • 2007 – Twilio (puhelut) • 2009 – Foursquare (mobiili maailma) • 2011 – Instagram
10. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Miksi kohistaan? • De jure “SOAP/XML” – SOAP "ideologian" taustalla on ollut lähtökohtaisesti business tarpeet, protokollan ideointi ja määrittely on ollut yritysvetoista. – Java driven • De facto “REST /JSON” – REST/JSON takana oleva "ideologia" edustaa jossain määrin joviaalia kehittäjäyhteisön pragmaattista lähestymistapaa. – Javasript driven • Internet of Things, Internet of BIG things – KoneCranes, KONE, yms... • Avoimen datan seuraava askel? (esim MyData) • Strategisesti merkittävä
11. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Palanen arvoketjussa Palanen arvoketjussa “Vain” yksi osa kokonaisuutta
12. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f API:n asiakkuudet API:n asiakkuudet Avoin API (innovaatiot) Kumppani API (yhteistyö) Sisäinen API (ketteryys) Pohja sama kaikissa – lisäominaisuuksilla, rajoitteilla erotellaan
13. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Kokemuksen suunnittelua Kokemuksen suunnittelua UI UX → API APX →
14. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f API:en kuvauskielet API:en kuvauskielet • Keskeiset API:en kuvauskielet: – RAML (yaml) → löydettävyys (apis.io) – Swagger → avoimesti julistanut tavoitteeksi de facto aseman – API Blueprint • IDE:t syntyy kuvauskielien päälle • Syntyy yhteistyöalustoja, ei vain kehittäjille • Syntyy ekosysteemin tukiranka
15. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Kehitetään yhteistyössä Kehitetään yhteistyössä Päällikkö Tuote päällikkö Markkinointi API kehittäjä Sovellus- kehittäjä API kuvaus API kehikko (Esim Node.js) generoidaan API Sovellus Dokumentaatio SDK API portaali generoidaan API tarjoaja API kuluttaja Sovellus- kehittäjä Koodi esimerkit Yhteisö
16. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Onnistunut APX - piirteet Onnistunut APX - piirteet • Itsepalvelu – kehittäjä omin avuin alkuun – Tunnuksien luonti, API keys, yms • Helpot, selkeät ja matalat integrointiaskeleet – TTFHW (time to frst hello world) • Dokumentaatio – Ajantasalla, selkeä, kehittäjäorientoitunut • Esimerkkikoodeja • Tuki ja palaute kanavat(24/7) – Itsepalvelu/yhteisön tuki: Stack exchange, quora... – suoran tuen ajat ja kontaktit (maksullinen kenties) • Selkeä käyttäjäsopimus – Yksityisyys – Oman yrityksen brändin suojaamista varten ohjeistus • Kojelauta – API:en hallinta yms
17. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Avoin API Avoin API • Avoimesti dokumentoitu: Rajapinta on määritelty ja sen dokumentaatio on verkon kautta avoimesti saatavilla ja vapaasti käytettävissä. Järjestelmän sisältämät tiedot, niiden rakenne ja rajapinnat on dokumentoitu riittävällä tarkkuudella, jotta rajapinnan käyttöönotto ja hyödyntäminen on mahdollisimman vaivatonta. • Käyttöönotettava: Avoin rajapinta on mahdollista ottaa käyttöön ilman ylläpitäjän tai järjestelmätoimittajan toimia myös virka-ajan ulkopuolella. Mahdolliset rekisteröitymiset ovat automaattisia. • Testattava: Rajapinnan tulee olla testattavissa. Testausta varten on tarjolla on vähintään testiaineisto. http://avoinrajapinta.fi/
18. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Avain asioita Avain asioita (muista edes nämä) (muista edes nämä) • Yksinkertaisuus ja intuitiivisuus ovat nykyaikaisen API:n piirteitä • Kevyet internet teknologiat (aka JSON) • APIt sosiaalisen median, pilvipalveluiden ja mobiilimaailman moottori • Laitteet (IoT), reaaliaikaisuus, automaatio ja ääni ovat API:n trendejä • Yhä helpompia pilvipohjaisia API:en julkaisuratkaisuja tulee koko ajan • API:t ja pilviteknologia ovat välttämättömiä digitaaliselle businekselle
19. .fi Sinun tiesi rajapintojen maailmaan apisuomi.f Kiitos Kiitos Jarkko Moilanen Twitter: @kyyberi API-lähettiläs Apisuomi.fi