2. Oma API-ajanlaskuni…
2003 – XML web
services
maataloushallinnossa
2009 REST API
Flickrin inspiroimana
2014 – ”Joo ei näin”
v2, ihan oikea REST
API
2016-2017 Keskon
API-kehitytä
vauhdittamassa
2017-2018 Digian
API-tiimi käyntiin
2018 API-talous –
kirja, konsultointia,
koulutuksia: eri
toimialojen API-
strategioita vauhtiin
3. API-talouden määritelmä
API-talous tarkoittaa, että yritys hyödyntää toisilla organisaatioilla olevia resursseja
(esim. data tai toiminto) tehokkaasti ja nopeasti tuottaakseen lisäarvoa omille
asiakkailleen. Hyödyntämisessä rakennuspalikoita ovat omat ja toisten tarjoamat
julkiset rajapinnat (maksulliset tai ilmaiset) sekä kehittäjäyhteisöt, joita
hyödyntämällä yritys pystyy vastaamaan nopeammin muuttuviin ja
ennakoimattomiin asiakastarpeisiin. API-taloudelle luonteenomaista on kilpailu
sovelluskehittäjien suosiosta, ja ensisijaisina asiakkaina pidetään sovelluskehittäjiä.
Toisin sanoen tarjotaan palveluita yrityksiltä kehittäjille (Business-to-Developers,
B2D).
Moilanen, Niinioja, Seppänen & Honkanen. 2018. API-talous 101 , Alma Talent
8. Mitä elämä on ilman APIa
Yksittäisiä, asiakas- tai kumppanikohtaisia integraatioharjoituksia alkaen 40 tunnista,
päätyen satoihin tunteihin
Sekalaisia tietomuotoja, tiedostoja ja tietomalleja
Kaukana asiakaskokemuksesta ja liiketoiminnasta
Ketterän ja hajautetun kehityksen vastakohta
9. Digitaaliset alustat tarvitsevat APIt
Rajaresurssit: ohjeet, ehdot, APIt, tunnistautuminen…
Suodattimet
Vuorovaikusta parantavat
algoritmit
Vuorovaikutukset
Muiden resurssit, joita voi hyödyntää
alustan kautta
12. ”Vahinko-APIn” synty ja ensiaskeleet
Ensimmäiset 12 kuukautta
Kehittäjillä
idea APIsta
Häh? Mikä
API?
API syntyy
(teknisesti)
Tuotteistus
APIsta
uskalletaan
puhua asiakkaille
Ensimmäinen iso
käyttöönotto APIa
hyödyntäen, paljon
muutoksia
APIsta tulee tärkeä
myyntivaltti
kilpailijoihin verrattuna
13. Moderni API saattaa syntyä
pakkoavioliitosta
Ensimmäiset 12 kuukautta
Poliittinen tahto
synnyttää kilpailukykyä
tai poistaa kilpailun
esteitä
Hallitusohjelma,
laki, direktiivi
Lausuntokierros
Valituksia, keskustelua,
tiedotusta jne.
”Häh, mikä rajapinta?
Miksi? Mitä hyötyä
meille? Apua
liiketoimintamalli
muuttui!”
API tai jokin
rajapinnan
kriteerit
täyttävä syntyy
15. APIen käyttö muutti työskentelyä
ENNEN APIA
”Katso kuinka hieno tämä meidän
sovelluksen käyttöliittymä on!”
”Asiakas pyysi apua järjestelmän
käyttöön – pyysin häneltä näytön
kuvia”
APIN JÄLKEEN
”Katso kuinka nopeasti saan
meidän sovelluksesta dataa ulos!”
”Asiakas tarvitsi apua, pyysin häntä
lähettämään tiedot API-kutsuista,
joita hän käytti”
16. API-talous vaatii poisoppimista
API on jotain ”teknonörttien” hommaa
API on erillinen asia ”oikeasta”
järjestelmästä
Uudet toiminnot ja muutokset voidaan
kehittää ilman, että muistetaan APIn
olemassaoloa
APIa tullaan käyttämään niin vähän ettei
käyttömäärien rajoittamiselle tai käytön
maksullisuudelle ole tarvetta
APIn hyödyntäminen testaukseen (tai edes
APIn testaaminen on vaikeaa)
API ei tarvitse käyttäjädokumentaatiota
Meidän sisäisen tietomallin käyttäminen
APIssa on ihan ok
Kaikki APIn käyttäjät voivat nähdä kaikki
APIn kautta kulkevat tiedot ja käyttää
kaikkia toimintoja
APIa tulevat käyttämään vain
”ulkopuoliset” / API tehdään ensin vain
sisäiseen käyttöön, joskus myöhemmin
sen voi avata muille, ehkä…
17. Tärkeimmät API-teesit
1. Rajapinnat ovat teknologia, joka vaikuttaa liiketoimintamalleihin
2. Rajapintoja hallinnoimaan tarvitaan koko yritys
3. API mahdollistaa vuorovaikutuksen alustatalouden toimijoiden kanssa
4. Rajapintojen ”pakkoavaus” saattaa kohdata liiketoimintamalliasi milloin tahansa. Näe se
mahdollisuutena.
5. Jos kilpailijasi tarjoavat (tai ovat pakotettuja tarjoamaan) rajapintoja, on voittava kehittäjäkokemus
rajapintojen käyttöönotossa merkittävä kilpailutekijä.
6. API-talous ei ole vain alustataloutta, rajapintoja voidaan käyttää sisäiseen tehostamiseen tai tarjota
eri liiketoimintamalleilla.
Luvusta 1: Varoitus: Saattaa muuttaa liiketoimintamalliasi, API-talous 101
19. ”App”, ”API” vai ”integraatio”
API IntegraatioApp
/products
/orders
/customers
Kutsu kerran tunnissa
PIM-järjestelmän tarjoamaan sisäisen REST -apiin
Tiedostonsiirto CRM:stä APIn toteuttavaan
mikropalveluun aina kun tiedot muuttuvat
Kutsuu ERPin SOAP-rajapintaa aina kun tulee uusi tarjous
Tiedostonsiirto APIn toteuttavasta mikropalvelusta
CRM:ään aina kun tiedot muuttuvat
/shipping
(rajapinta joka laskee kuljetuskustannukset annettujen postinumeroiden
välillä, mikropalveluun tallennettujen hintojen perusteella)
/images
(kuvia CDN:stä)
20. APIt ovat läsnä kaikissa näissä arkipäivän
tilanteissamme
Lainsäädännöllä ”pakkoavattuja” rajapintoja
Julkisuuslaki
LippurajapinnatPSD2
22. Missä luuravat muun maailman API-
talouden menestystarina?
APIen ja Startup Growth –indeksin välillä
on tutkittu korrelaatio
Jotkut yritykset kukoistavat APIen avulla
toimivan alusta-liiketoimintamallin avulla
Amazon Web Services
Google
Facebook
Alibaba
Salesforce
AirBnB
Uber
Netflix
Lähde: Huhtamäki & al. Visualizing the Geography of
Platform Boundary Resources: The Case of the Global
API Ecosystem
26. Onko meillä ongelma?
POST /add
POST /del
Käsintehtyjä
dokumentaatioita
200-tietokenttää kerralla, vain siksi
“koska meilla on ne”
Sensitiivistä tietoa URI-parametreissa
Palvelimet pitää buutata, jotta saadaan uudet API-käyttäjiä
sisään
“Basic auth on ihan hyvä”
27. Hyvä tapa
✓ Ja huono tapa
⛔
Kehittää API
API-kehittäjäksipäätyväteivät
useintiedäettäonolemassa…
28. Olemme kaikki kotoisin eri
kylistä ja kopioimme
huonoa designia olemassa
olevista rajapinnoista
Maalaisjärki
+ aiempien APIen kopiointi
29. 💁🙎
Kaikki nämä ihmiset
osallistuvat omalla tavallaan
APIen kehitykseen
CX, UX, Service designerit, Markkinointi
& myynti, hankinta, juristit, HR,
ohjelmistokehittäjät, yritysarkkitehdit,
vekko- ja turvallisuusasiantuntija,
mikropalvelu- ja integraatioarkkitehdit,
pilviasiantuntija ja tietoarkkitehdit,
projekti- ja palvelupäälliköt, testaajat
jne.
Heillä kaikilla on omat
kielensä, menetelmänsä ja
prosessinsa.
Kuinka heidät voidaan saada
puhumaan samaa kieltä ja
toimimaan yhteen, jotta
saadaan kehitettyä hyviä
rajapintoja.
30. Menetelmä ?
Havainnointi ja
reflektointi
Abstraktien käsitemallien
muodostaminen
Testaaminen
uusissa
tilanteissa
Asiantunti-
juus
Konkreettinen kokemus
MotivaatioOsaaminen
Konstrukti-
vistinen
oppimis-
käsitys
”Mitä se on mitä teen, kun olen tiimin
kanssa kehittämässä hyvää APIa?”
31. Syntyi APIOps® Cycles menetelmä
http://cycles.apiops.net/ joka
kehitettiin työskennellessäni Digialla.
Digia antoi menetelmän APIOps.net
yhteisön käyttöön avoimella lisenssillä
(CC-BY-SA 4.0). Yhteisön käynnisti
APInf Oy.
Osaango Oy kehitti menetelmää
eteenpäin, myös avoimella lisenssillä:
https://www.apiopscycles.com/
32. Miksi vain UX kehittäjillä
olisi käytettävyysprosessi?
DevOps ei ole riittävä API-
kehitykseen…
35. Prototype
Just enough
Scale
Leanillä arkkitehtuurilla ketterää
kehitystä
Minimum Viable Architecture syntyi
tarpeesta tehdä arkkitehtuuria ketterästi
ketterissä projekteissa. Ja kehittää ja kuvata
vain tarpeeseen.
Lainasimme sen menetelmään ja
kehitimme Minimum Viable API
Architecture – version.
Prototype
36. APIAudit–tarkistuslista
pelastaa
kokemattomammankin
API-kehittäjän
API Audit –tarkistuslista kerää kaikki
aloittelijan mokat API-suunnittelussa.
Myös kokenut kehittäjä voi olla
aloittelija alkaessaan kehittää APIa.
Usein hekään eivät muista validoida
skeemojaan tai laittavat sensitiivistä
tietoa URI-parametreihin.
Tarkistuslista auttaa
kehittäjäkokemuksen turvallisuuden,
analytiikan ja API-
hallintateknologioiden käyttöönotossa.
Ja helpottaa uusien kehittäjien
ottamista mukaan.
37. Ke
y
act
ivit
iesKe
y
res
ou
rce
s
API
value
proposi
tion
API
design
and
implem
entatio
n
Lisäarvo
Hyödyt ja esteet käyttäjille
muunnetaan tarjottaviksi API-
tuoteominaisuuksiksi ja
lisämateriaaleiksi jne. Mieti myös
muiden tarjoamien APIen käyttöä
Palvelupolku
Yhden käyttäjäryhmän tai
järjestelmän toimenpiteet
listataan API Value Propotion
Canvakselle analysointiin
API-tuotteet ja/tai muut palvelut
Ominaisuudet ryhmitellään API-tuotteiksi ja
muksi palveluiksi. Älä päätä tehdä (vain)
APIa ennen kuin olet tehnyt Canvaksen
loppuun ja haastatellut tulevia käyttäjiä
Yksi API-tuote kerrallaan API
Canvakseen
Keille muille saman lisäarvon
tuottavasta APIsta on hyötyä?
Miten tavoitat heidät?
Millä liiketoimintamallilla API tarjoaa,
mitä tuloa, säästöä tai muuta
lisäarvoa se tarjoaa?
Mitä ratkaisuj ja komponentteja
meillä on jo valmiina tätä APIa
varten? Keitä apuun? Mitä tarvitaan
lisää?
Mitä kustannuksia syntyy?
Onko tämän APIn tekeminen kannattavaa?
Kustannukset vs. vaikutus liikevaihtoon ja
strategiaan
123
4
5
6
7