API HAckathon Tournee 2014
Porin tapahtuma 15.10.2014, klo 13-20
Random new issues
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):
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 :)
- IMS/tekla pori kaupunki kotiosoite ja ympärillä olevat lähinnä palvelut (santeriv)
- 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:
hoottps://oiva.evira.fi/kohteet/tunnus/raportit/raporttiList[index].tarkastusTunnus/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
- 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.