API HAckathon Tournee 2014
Porin tapahtuma 15.10.2014, klo 13-20

Paikallinen yhteyshenkilö: Petri Linna

Yhteyshenkilön puh/email/jotain: petri.linna@tut.fi, 0408262720

Logo: http://apisuomi.fi/logot/#hackathon

hashtag: #apihackfinland

Random new issues

Added to CodeWeek: http://events.codeweek.eu/view/451/api-hackathon-pori/

UpCloud tarjoaa alustaa devaajien käyttöön: https://twitter.com/ApiSuomi/status/514298794448805888

Ennen tapahtumaa:

Ilmoittaudu, jotta tiedämme ruokamäärän ja tilojen mitoitustarpeen.

Mieti ja suunnittele omaa API ideaasi jo etukäteen, joko yksin tai ryhmissä. Tarkoituksena on että tapahtumassa voi kysellä apuja toisilta.

Lisää ideasi tai ratkaistava ongelma Trello-sovellukseen (https://trello.com/b/WOVdK5ef/api-pori-2014 tai tämän muistion loppuosaan.

Tutustu API Starter kit -dokumentaatioon. Dokumentaatiota kehitetään kiertueen aikana, joten rakentava palaute on tervetullutta.

Teema: API listing strategy for education (and business). API:t voivat olla kuitenkin mistä aihealueesta tahansa.
Tapahtumapaikka/location:
- Porin yliopistokeskus, Pohjoisranta 11A. API Hacktathon on luokassa 334. Opastus yliopistokeskuksen aulasta.
- Tilaan on varattu omille koneille sähköroikkia
- Tilaan varataan oma lähiverkko?
- Parkkeeraus: pumpulikadun kautta 2h parkkialueelle, jonne saa infosta päivän P-lipukkeita. Ilmainen kadunvarsialue, esim. luotsinmäenpuistokatu.
Lunch: Ruokaisa salaatti n. klo 17.00. Sisältäen mm. kahvin, ruokaisan salaatin, täytettyjä leipiä. Ruokailun tarjoaa TTY:n Porin laitos.
Ohjelma/program suggestions:

Jarkko Moilanen, API suomi, teoriaa ja käytäntöä

Discussions/Workgroup on API strategy: Do we need apis.io (http://apis.io/) in Finland? How to promote APIs?

Pori Hacklab esittäytyy.

Local business presenting a API case/development. ??

Local developer working with shared concepts/APIs/apps

demo at the end of the day what was achieved, best are rewarded

Rekisteröityminen/register
Use either one, both will be created by the organizers (API:Suomi):

Facebook tapahtuman linkki: https://www.facebook.com/events/317804578402175/

webropol: https://www.webropolsurveys.com/S/6EC81C772F22832D.par

API Strategy

New point was raised. That is it will be a great idea to have the data caching by the API provider or API proxy

Hackathon ideoita

https://bitbucket.org/jounhi/hattiwatti - my-data pori energia (santeriv) ++1 :)

https://github.com/okffi/kraftfolk

hackathonin alkaessa fortumin sekä pori energian palveluihin ei saada yhteyttä

IMS/tekla pori kaupunki kotiosoite ja ympärillä olevat lähinnä palvelut (santeriv)

esim. http://kartta.pori.fi/IMS/fi/Search?Op=all&Name=pohjoisranta%2011&_=141214400772 )

CORS check -> failed

mobilized JSON API with JSONP using jsonp.jit.su for demoing purposes

http://jsonp.jit.su/?callback=mycallback&url=http%3A%2F%2Fkartta.pori.fi%2FIMS%2Ffi%2FSearch%3FOp%3Dall%26Name%3Dpohjoisranta%252011

ajatuksena oli tehdä mobiili sovellus käyttäen JqueryMobile Boilerplate github projektia pohjana sekä avoimen koodin eri-alustoja tukevaa builder.phonegap.com palvelua käyttäen https://c9.io devausympäristönä

https://github.com/santeriv/pori-local-data-mobile-ui (vasta aihio jqm boilerplatesta)

Evira ja Oivahymy, https://www.oivahymy.fi/ data screipattuna

Elintarvikehuoneistojen tarkastustulokset olisi hyvä saada avoimena datana jakoon rajapinnan kautta. Niitä hyödyntäen voisi esim. rikastuttaa ravintolatietoja ja -arvioita listaavia palveluja ja yhä useampi kuluttaja saavuttaisi viranomaisen tekemät tarkastustulokset.

Huhujen mukaan oivahymy.fi:ssä on rajapinta, jonka ainakin yksi näppärä kehittäjä on löytänyt ja hyödyntänyt mobiilisovelluksessaan [1]. Rajapintaa ei ole dokumentoitu eikä sitä mainita missään ohjeistuksessa.

Mikäli joku haluaa tehdä scrapata Oivahymy -datan ja tehdä REST -rajapinnan, niin Open Knowledge Finland voi hostata rajapintapalvelua. Tavoitteena olisi positiivisen "kansalaistottelemattomuuden" kautta osoittaa avoimen datan hyödyt Eviralle ja auttaa heitä avaamaan data virallisesti.

[1] http://www.windowsphone.com/fi-fi/store/app/oiva-hymi%C3%B6/4081052c-24de-49b6-b9bd-c0c4593fe17a

JSON API löytyi:

eviralta (https://oiva.evira.fi/?lang=fi&kunta=pori&advanced=true&#kunta=pori&advanced=true&) löytyy mm. seuraavat 'valmiit' JSON API:t (CORS-tuki??):

https://oiva.evira.fi/kohdetyypit/?ov=1.1.2

https://oiva.evira.fi/kohteet/basic/?text=Pori&ov=1.1.2&mode=

https://oiva.evira.fi/kohteet/advanced/?nimi=Mar&katu=&postinumero=28100&kunta=pori&advanced=true&ov=1.1.2&mode=

tarkempi tieto löytyy pdf:stä joka saadaan muodostamalla yo. JSON vastauksesta

raporttikohtainen tarkastusTunnus ja tunnus urliin

hoottps://oiva.evira.fi/kohteet/tunnus/raportit/raporttiList[index].tarkastusTunnus/pdf

esim. https://oiva.evira.fi/kohteet/241548/raportit/97859/pdf

Tuli tuossa vastaan mielenkiintoinen Apigeen kehittämä avoimen lähdenkoodin toolkit, jolla voi määritellä helposti toimivan rajapinnan swaggerillä joko YAMLilla ja JSONilla. Toolkit toimii node.js:n päällä ja vaatii javascript osaamista ainoastaan controllerien koodauksessa ja hoituu muuten pelkällä määrittelyllä. Tein mielenkiinnosta ensimmäisen toteutuksen rajapinnasta ja sen on nyt jaossa githubissa https://github.com/teemujonkkari/oiva-api. Laitoin palvelun pyörimään myös UpCloud-palvelimelle osoitteeseen http://185-20-139-22.fi-hel1.host.upcloud.com/haku?hakusana=Pori, mutta se ei taida siellä kauaa ilmaiseksi toimia.
rajapintoja on nyt

/kohdetyypit joka palauttaa kohdetyypit, vastaus JSON

/haku joka palauttaa yhdellä hakusanalla löydetyt, vastaus JSON

/edistynyt_haku jolla voi hakea useammalla arvolla samaan aikaan, vastaus JSON

, /raportti/pdf palauttaa pdf-tiedoston

ja raportti/huomiot joka rippaa pdf-dokumentista tarkastajan sanallisen komenttit (huomiot)

Mitä puuttuu:

PDF rippaus onnistui toistaseksi vain paikallisesta tiedostosta joten suora luku verkosta vielä kesken. käytetään pdf-extract modulia, jota pitäis vähän konffata tätä varten

Swagger asiantuntijaa&dokumentoijaa kaivataan myös. Tässä käytetään swagger 2.0 versiota dokumentit generointiin.

http://www.jonkkari.com/oiva-api/ generoitunut dokkari

Tarvitaan:

Swagger taitaja

Pysyvä koti palvelulle

Pdf rippauksen korjaaja

Kommentteja ja kehitysehdotuksia

Maanmittauslaitoksen API:n "auditointi" käyttäjänäkökulmasta

http://fi.okfn.org/2014/10/15/testaamaan-maanmittauslaitoksen-apia/

HILMA:n API -keskustelu

Hankintailmoitusrekisteri HILMA:sta on saatavilla tietoja rajapinnan yli kolmansille osapuolille. Rajapinnan tarvitsija esittää pyynnön sähköpostitse ja saa vastauksena sopimuspohjan ja rajapintakuvaukset. Sopimuksen liitteeksi pitää antaa palvelukuvaus palvelusta, johon HILMA:n dataa käytetään.

Yhteyshenkilö: Alpo Jurvakainen, alpo.jurvakainen[at]ely-keskus.fi

Karri: Olin elyn edustajaan yhteydessä ja sieltä tuli vihreätä valoa. "Selvitin asiaa ja tulos oli se, että tietoja saa hakea rajapinnan kautta ja tallentaa niitä tietokantaan ja tarjota avoimesti eteenpäin."

https://www.facebook.com/groups/hallinnon.avoin.data/permalink/700026690091529/

Sain Alpo Jurvaselta sopimuspohjan ja rajapintakuvauksen about puolessa tunnissa parilla sähköpostilla. Rajapinta on melko simppeli http get, jossa parametreinä ilmoitustyyppi ja alkupvm ja loppupvm ja tuloksena on hankintailmoitukset ko. aikavälillä. Tuon aikaikkunan max pituus on 24 tuntia eli yhdellä kysellä saa ainostaan yhden päivän aikana tehdyt ilmoitukset. Protoilen tässä vielä lisää mitä syntyy kun yhdistelen hankintailmoitusten tuotetietoon.