Lisää ainoastaan ohjelmointirajapintoja rajapintana avoindata.fi:hin. Jos haluat lisätä rajapinnan kautta saatavia aineistoja, lisää ne tietoaineistoina.
Ohjelmointirajapinnat eli APIt (Application Programming Interface) ovat dokumentoituja rajapintoja, joiden avulla ohjelmistot, sovellukset tai järjestelmät voivat vaihtaa keskenään tietoa tai toimintoja. Ohjelmointirajapinta tarjoaa tietoa tai toimintoa koneluettavassa, dokumentoidussa muodossa siten, että jokin toinen ohjelmisto, sovellus tai järjestelmä voi sitä ohjelmallisesti hyödyntää. Esimerkiksi joukkoliikenteen rajapinta kertoo reittiopas-sovellukselle, milloin bussisi saapuu pysäkille.
Voit lisätä rajapintoja, kun olet rekisteröitynyt palveluun ja kirjautunut sisään. Sinulla tulee myös olla Ylläpitäjä- tai Muokkaaja-roolin oikeudet siinä organisaatiossa, jolle haluat lisätä rajapinnan. Lue lisää jäsenyydestä Organisaation jäsenet -osiosta.
Jos organisaatiotasi ei ole vielä lisätty palveluun, lue, miten lisäät uuden tuottajan.
1. Lisää ja kuvaile rajapinta
Lisää rajapintoja Rajapinnat-sivulta Lisää rajapinta -painikkeesta.


Tarkista ensin, onko joku muu organisaatio julkaissut samankaltaista dataa kuin olet itse julkaisemassa. Jos on, ota mallia heidän julkaisustaan ja käytä esimerkiksi samanlaisia avainsanoja ja kategorioita.
Näin lisäät rajapinnan
Aloita lisääminen täydentämällä rajapinnan kuvailutiedot eli metatiedot ja lisää sen jälkeen linkki rajapintaan tai sen dokumentaatioon. Pakolliset kentät ovat merkitty lomakkeeseen tähdellä *.

Kuvaile rajapinta kattavasti, sillä se parantaa sen löydettävyyttä ja helpottaa datan hyödyntämistä.
Lisää metatiedot myös ruotsiksi ja englanniksi, jotta muutkin kuin suomenkieliset datan hyödyntäjät voivat käyttää dataa. Datat kopioituvat myös Euroopan yhteiseen data.europa.eu-palveluun, josta kansainväliset hyödyntäjät löytävät datan.
- Anna rajapinnallesi nimi, joka kertoo:
- Kirjoita kuvaukseen:
- Millaista dataa rajapinta tarjoaa?
- Esimerkiksi, millaisia paikkatietoaineistoja sen kautta on saatavilla.
- Missä rajapinnan tarjoamaa dataa voi hyödyntää?
- Jos jokin organisaatio ottaisi rajapinnan käyttöönsä, mitä organisaatio voisi rajapinnan avulla tehdä.
- Mitä rajapinnan käyttöönottovan organisaation pitää tehdä, jotta se voi alkaa käyttää rajapintaa?
- Mistä organisaation edustaja voi lukea lisää rajapinnan toiminnasta, sen käytöstä ja sen tarjoamasta datasta?

- Lisää rajapintaa kuvaavia avainsanoja ja sille sopivat kategoriat.

- Avainsanat-kenttä ehdottaa jo aiemmin käytettyjä avainsanoja. Suosittelemme käyttämään paljon käytössä olevia avainsanoja.
- Valitse rajapinnan näkyvyydeksi julkinen, sillä kaikki palvelussa oleva data on julkista avointa dataa, eikä palveluun saa lisätä yksityiseksi tarkoitettuja aineistoja. Jos haluat pitää rajapinnan väliaikaisesti luonnostilassa esimerkiksi testausta tai tietojen täydennystä varten, valitse tilaksi yksityinen.

- Yksityinen rajapinta näkyy kaikille sen julkaisseen organisaation jäsenille.
- Valitse rajapinnan tarjoamalle tiedolle sen käyttöehdot määrittelevä lisenssi. Avoimella datalla täytyy aina olla avoin lisenssi. Valitse joko CC BY 4.0 tai CC0 1.0 -lisenssi:

- Creative Commons Nimeä 4.0 (CC BY 4.0) -lisenssiä käytettäessä datan hyödyntäjän pitää nimetä datan alkuperä, tarjota linkki lisenssiin ja kertoa, jos dataan on tehty muutoksia.
- Creative Commons CC0 1.0 -lisenssi ei määrittele tietoaineiston uudelleenkäytölle minkäänlaisia rajoitteita. Tätä lisenssiä käytetään usein metatietoihin.
- Jos käytät CC-BY-4.0-lisenssiä määrittele rajapinnan kuvaukseen, miten haluat, että organisaatiosi nimetään, kun joku hyödyntää rajapinnan tarjoamaa dataa.
- Määrittele rajapinnan käyttöehdot.
- Kerro, vaatiiko rajapinnan käyttö API-avaimen ja jos vaatii, mistä sen voi saada. Jos rajapinta vaatii rekisteröitymisen, kerro rekisteröitymisprosessista tässä.

- Anna linkki rajapinnan käyttöehtoihin ja mahdolliseen palvelutasolupaukseen (SLA).
- Kerro myös mahdollisista muista rajoitteista rajapinnan käytössä.
- Lisää rajapintaa ylläpitävän organisaation tiedot. Käytä organisaation yleistä sähköpostia esimerkiksi kirjaamo@organisaatio.fi tai avoindata@organisaatio.fi.
- Lisää rajapinnan ylläpitäjäksi joko organisaatio tai esimerkiksi organisaation yksikkö tai osasto, joka on vastuussa julkaistusta datasta.

- Siirry lisäämään linkki rajapintaan tai sen dokumentaatioon valitsemalla Seuraava.
- Lomakkeella näkyvistä tyhjistä muokattavista kentistä ei tarvitse välittää. Niitä voi käyttää, jos haluat lisätä tietoaineistolle tietoa, jolle ei ole lomakkeella omaa kenttää. Niihin kirjoitettu tieto ei näy tietoaineiston sivulla.

2. Lisää linkki rajapintaan tai sen dokumentaatioon
3. Liitä rajapinnan tarjoamat tietoaineistot rajapintaan
Jos rajapinnan tarjoamista tiedoista on koostettu tietoaineistoja, voit liittää ne rajapintaan. Tietoaineistojen pitää ensin olla lisätty avoindata.fi:hin.
Esimerkiksi paikkatietorajapinnoista voi olla tarve koostaa erilaisia karttatasoja omiksi aineistoikseen, kuten sillat, ajorajat tai vesistöt. Nämä aineistot voi liittää itse paikkatietorajapintaan, jotta ne löytyvät avoindata.fi:stä helpommin.
Näin liität tietoaineistot rajapintaan
Varmista, että olet lisännyt tietoaineistot sekä rajapinnan ensin avoindata.fi:hin.
- Valitse rajapinta, johon haluat liittää tietoaineistoja ja valitse Muokkaa rajapintaa.
- Valitse välilehti Liitä tietoaineistoja.
- Etsi tietoaineistoja niiden nimellä ja paina enter suorittaaksesi haun.
- Valitse liitettävät tietoaineistot ja tallenna valinnat valitsemalla Liitä rajapintaan.
- Tietoaineistot on nyt liitetty rajapintaan. Näet ne rajapinnan sivulla.
Voit poistaa liittämäsi tietoaineistot samalta Liitä tietoaineistoja -välilehdeltä.
- Valitse ensin tietoaineisto, jonka haluat poistaa rajapinnasta ja sitten Poista rajapinnasta.