Avoimen tiedon (datan) tuottajilla on usein tarve hakea ja päivittää tietoaineistoja tai niitä kuvaavia metatietoja säännöllisesti. Kun tiedot ovat valmiina tietojärjestelmässä, kannattaa toistuvat rutiinit automatisoida palvelun rajapintojen avulla.
Avoindata-palvelu sisältää REST/JSON-rajapinnat, joiden päälle nykyiset käyttöliittymät on rakennettu. Kaikki Avoindata-palvelussa olevat tiedot on saatavilla rajapintojen avulla.
Palvelun tavoite on, että mahdollisimman moni avoimen datan tuottaja julkaisisi automaattisesti päivittyvät tiedot palvelun rajapintojen avulla. Automaattiset päivitykset pitävät tiedot paremmin ajan tasalla, datan laatu nousee ja hyödyllisyys kasvaa.
Jos haluat muokata tai lisätä tietoja rajapintojen avulla, tarvitset API-tokenin. Alta löydät ohjeet API-tokenin luomiseen Avoindata-palvelussa.
- Kirjaudu sisään palveluun. Jos sinulla ei ole vielä käyttäjätunnusta, rekisteröidy ensin palveluun.
- Valitse sivun yläreunasta oma käyttäjätunnuksesi (tässä esimerkissä se on "testikäyttäjä").
API-token
Saat luotua API-tokenin seuraamalla alla olevia ohjeita.
1. Navigoi omaan profiiliisi ja valitse API-tokenit välilehti luodaksesi API-tokenin.
2. Anna tokenille nimi ja valitse Luo API token.
3. Sivun yläreunaan tulee ilmoitus, josta voit kopioida oman API-token koodisi. Ota koodi talteen, sillä sitä ei saa palautettua, jos kadotat sen, vaan sinun täytyy luoda uusi token.
API-tokenit välilehdellä voit poistaa ja luoda uusia tokeneita. Poistaminen lopettaa tokenin toiminnan.
JSON (JavaScript Object Notation) on yksinkertainen avoimen standardin dataformaatti tiedonvälitykseen. Nimestään huolimatta se on JavaScript-ohjelmointikielestä riippumaton.
JSON-dataformaatti ei aina näytä internet-selaimessa selkeältä. Selaimiin on kuitenkin saatavilla erilaisia laajennuksia, jotka muotoilevat sen ihmiselle helpommin luettavaa muotoon.
Selainlaajennoksia JSON:n muotoiluun
Alla on esimerkki oikein muotoillusta JSON-dataformaatista, josta ihmisen on helppo erottaa tietosisältö.
