Rajapinnat liiketoiminnan tukena – API tuotteena

Esitetty API Camp kurssilla TAMK:ssa 11.1.2017

Transcript

1. DX eli Developer eXperience API Camp 11.1.2017 - Jarkko Moilanen Miten saan kehittäjät rakastumaan rajapintaani?
2. Kehittäjäkokemus • Developer eXperience eli kehittäjäkokemus • Kohderyhmä on API:n hyödyntäjät eli kehittäjät – Yrityksen sisällä ja ulkopuolella. • Kehittäjä on kuningas, kehittäjät ovat API- talouden rokkitähtiä. • Rajapintamarkkinoilla kilpailu lisääntyy
3. Toivottu kehitys Käyttäjämäärä Aika
4. Hockey stick ei toivottu oppimiskäyränä vaativuus ominaisuudet API:n DX vaatii viilausta
5. Kehittäjäkokemuksen mittaaminen TTFHW – Time to First Hello World …ja miten lyhentää sitä Kopioitavat koodiesimerkit Ajantasainen helppokäyttöinen dokumentaatio Rajapinnalla selkeä tarkoitus Automatisoitu, nopea rekisteröityminen Työkaluja (API konsoli, yms)
6. Kehittäjäkokemuksen mittaaminen 3 – 30 – 3 sääntö •3 sekunnissa ymmärtää miksi rajapinta on olemassa •30 sekunnissa päästä tiedon lähteille •3 minuutissa: tunnukset ja ensimmäinen API:n kokeilu
7. Esitä vastaukset ainakin näihin 1. Minkä ongelman API ratkaisee? Miksi se on olemassa? (miksi tutustuisin) 2. Miten otan sen käyttöön? (kynnys) 3. Mistä löydän tukea? (dokumentaatio+) 4. Mitä se maksaa? (kustannus, plans) 5. Mikä API:n tulevaisuus on? (jatkuvuus) 6. Mikä on API:n luotettavuus? (teho + vastuutaho)
8. 1. Miksi API on olemassa? (miksi tutustuisin) Markkinoilla on tai tulee olemaan vaihtoehtoja • Otsikosta pitää ilmetä miksi API on tehty. • 3 sekuntia aikaa saada kehittäjä jatkamaan • Otetaan esimerkkejä ja arvioidaan…
9. Uljas API • Yritykset ja yksityishenkilöt voivat nyt hakea Tullin ulkomaankaupan tilastotietoja koneellisesti. • Tullin Uljas-tilastotietokannan avoimen datan rajapinta eli API (Application Programming Interface) mahdollistaa tilastotietojen ja niiden metadatan hakemisen Uljas- tietokannasta csv, json, json-stat ja xml - muodoissa.
10. Huuto API • Huuto.net-palvelut tarjoaa rajapinnan, SOMT- API:n (Sanoma Online Marketing Tool) ohjelmoijien käyttöön. Voit integroida muita järjestelmiä toimimaan yhdessä huuto.net:in kanssa, tai kehittää uusia sovelluksia rajapinnan päälle.
11. OpenStreetMap Editing API • OpenStreetMap has an Editing API for fetching and saving raw geodata from/to the OpenStreetMap database
12. VTJkysely Sovelluskysely "Henkilötunnuksella haku" • VTJ-rajapinta on palvelu, jossa asiakkaan tietojärjestelmä lähettää yksittäisen kyselyn väestötietojärjestelmään. Väestötietojärjestelmästä palautetaan asiakkaan tietojärjestelmälle XML-muotoinen vastaussanoma.
13. YTJ tiedot • Hae yritys- ja yhteisötietojärjestelmään merkittyjä yrityksiä hakutermien avulla
14. 2. Miten API toimii? (kynnys) Tavoite on tehdä kynnys niin matalaksi kuin mahdollista Tässä vaiheessa ei pidä joutua turvautumaan dokumentaatioon, tarkoitus on koukuttaa.
15. 2. Miten API toimii? (kynnys) • Selkeä kuva/vaiheet mitä pitää tehdä? 1-2-3 Done! • Rekisteröityminen hyödyntäjäksi itsepalveluna – Github tunnuksilla? Ensimmäinen vaihe ei voi olla rekisteröityminen tai tunnuksien hakeminen lomakkeella – Tai odottaa viikkoa tunnuksien saamista
16. 2. Miten API toimii? (kynnys) • Voinko kokeilla selaimessa heti? – hiekkalaatikko / live dokumentaatio (Swagger) • Miten liitän tämän omaan koodiin? – copy-paste koodiesimerkit, SDK:t • Loputtomasti asioita joita voi parantaa. Vain kokemuksen ja mittaamisen kautta löydätte.
17. 3. Mistä löydän tukea? (dokumentaatio+) Kehittäjä ei saa jäädä yksin sormisuussa ihmettelemään • Ajantasainen, selkeä ja seksikäs dokumentaatio • Käytä yhteisöjä (esim Stack Overflow) – hakukoneet löytää nämä useasti helposti – Opasta käyttämään, tee linkki sopiviin paikkoihin. Linkillä luodaan uusi kysymys Stack Overflowhun…
18. 3. Mistä löydän tukea? (dokumentaatio+) • Slack yhteisö/tuki? – ei välity tieto hakukoneille ja jää suljettuun piiriin • Chat tuki developer sivuilla? – suora tuki yhdelle kehittäjälle • Puhelinnumero ja email selkeästi esillä • Yksi tukimuoto ei riitä
19. Dokumentaatiosta esimerkkejä • Live dokumentaatio – http://avoindata.prh.fi/ytj.html#!/v1/search – https://developer.payeezy.com/apis/payeezy-api • Staattinen – https://stripe.com/docs/api – http://developers.gettyimages.com/api/docs/ – https://developers.facebook.com/docs/videos/liv e-video
20. 4. Mitä se maksaa? (kustannus, plans) • Selkeät mallit hinnoitteluun • Älkää piilotelko hintoja • Usein kannattaa tarjota ilmaiskäyttö rajoitetusti – mahdollistaa kokeilun/opettelun ja koukuttaa – saa enemmän tietoa rajapinnan käytöstä (mitkä kutsut eniten/vähiten kiinnosta yms) – vrt käyttäjien kalastelu sovelluksiin freemiumilla
21. Hinnoittelusta esimerkkejä https://www.fullcontact.com/developer/pricing/
22. Hinnoittelusta esimerkkejä http://www.quriiri.fi/hinnasto
23. 5. & 6. Mikä API:n tulevaisuus on? (jatkuvuus ja ominaisuudet) • Worst case scenario esimerkki: – http://m.slashdot.org/story/320995 • Arvioikaa riski sille, että kauanko API on olemassa – startup, riski lienee kohtalaisen korkea – iso globaali yritys, monesti turvallisempi muttei aina – Ottakaa siis selvää kuka rajapinnan takana on • Open source alusta/toteutus vähentää riskiä • Jos ainut vaihtoehto, riski isompi • Onko tiekarttaa kehityksestä? – voiko siihen osallistua jotenkin?
24. Miten toteutan kehittäjäkokemuksen? • Jatkuva parantaminen • Kehittäjäportaali tai vastaava (Developer program) – hyvä esimerkki: https://www.twilio.com/docs/ • Seuraa kehittäjien käyttäytymistä (mittarointi) – API hallinnasta käyttötilastot (API avain yksi tapa) – Kehittäjäportaalissa – Alustoilla – Keskeisillä kehittäjäfoorumeilla • Osallistukaa hackathoneihin ja käyttäkää tilaisuutta keskustella kehittäjien kanssa
25. Developer program Ennen vietiin pomot Leville, nyt lahjotaan kehittäjiä… • Kaikki edellä mainittu ja loput omasta luovuudesta kiinni. Lisäarvoa kehittäjälle • Webinaareja • Lippuja tapahtumiin • Muita etuja
26. Päivän harjoitustyö • Arvioikaa alla olevat DX:t – https://www.twilio.com/docs/ – http://developer.reittiopas.fi/pages/en/home.php – https://stripe.com/docs/api • PDF / PPT muodossa tiimin kanavalle tuotos • Esitys päivän päätteeksi
27. ”Lopputyö” • Vertailkaa valitsemienne kahden API:n / yrityksen DX:ää. • Käyttäkää aikaa ja vaivaa. • 3 näkökulmaa: Mitä hyvää, mitä huonoa, miten voisi parantaa – lista asioista joita tarkastella seuraavalla sivulla. • Palautus 15.2. klo 16 mennessä – esitys kaikille.
28. ”Lopputyö” - miten hyvin alla olevat tehty/tuotu esille? • Minkä ongelman API ratkaisee? Miksi se on olemassa? (miksi tutustuisin) • Miten otan sen käyttöön? (kynnys) • Mistä löydän tukea? (dokumentaatio+) • Mitä se maksaa? (kustannus, plans) • Mikä API:n tulevaisuus on? (jatkuvuus) • Mikä on API:n luotettavuus? (teho + vastuutaho)