Avoin data

Lahden ammattikorkeakoulu tarjoaa tietoaineistoja julkiseen käyttöön avoimen datan rajapintojen kautta. Rajapinnat ovat julkisia, mutta niiden käyttäminen vaatii rekisteröintiä ja sitä kautta saadun avaimen käyttöä tiedon hakemiseksi.

Rajapinnat

LAMK tarjoaa avoimeen käyttöön seuraavat REST-rajapinnat:

•    Opetussuunnitelmat
•    Opintojaksot
•    Opintojaksojen toteutukset
•    Varaukset

Tarjottavien tietoaineistojen määrä tulee lisääntymään.

Rajapintojen käyttö

LAMK data portaali

LAMK data -portaalista https://data.lamk.fi löytyy tarkempia tietoja ja esimerkkejä rajapintojen käytöstä.

API-avain

Rajapintojen käyttämiseksi tarvitaan API-avain, joka saadaan rekisteröitymällä palveluun LAMK data portaalin kautta. Lomake käsitellään, jonka jälkeen avain lähetetään sähköpostilla rekisteröityyn sähköpostiosoitteeseen. Rekisteröitymällä käyttäjä hyväksyy myös LAMK avoimen datan käyttöehdot.

Rajapinnan kutsu

Rajapintoja kutsutaan käyttäen HTTPS-protokollaa sekä GET- tai POST-metodeja haettavasta tiedosta riippuen. POST-metodikutsuja käytetään monipuolisempien hakuehtojen yhteydessä.

Tunnistautuminen

Rajapintojen tunnistautuminen tehdään asettamalla API-avain pyynnön Ocp-Apim-Substriction-Key otsikkokenttään.

Kieleistys

Rajapintakutsuja on mahdollisuus tehdä joko suomeksi tai englanniksi. Kieleistys määritellään joko HTTP otsikkokentällä Accept-Language tai kutsuparametrilla l (pieni l-kirjain).

Päivämäärät

Päivämäärät kutsuissa ovat seuraavan esimerkin mukaisessa muodossa: 2018-06-12T08:00.
 

Käyttöehdot

Lahden ammattikorkeakoulun avoimen datan rajapintojen käyttö on maksutonta, mutta vaatii rekisteröinnin. Rekisteröitymällä sitoutuu noudattamaan näitä käyttöehtoja.

Rekisteröinnissä on ilmoitettava hakijan nimi, mahdollinen organisaatio ja sähköpostiosoite. 

Saatu avain on henkilökohtainen eikä sitä saa luovuttaa kolmannelle osapuolelle. Lahden ammattikorkeakoulu seuraa avainten käyttöä ja voi lopettaa rajapinnan käytön, mikäli todetaan palvelua käytettävän hyväksytyn käyttötarkoituksen vastaisesti tai muuten rikotaan näitä sääntöjä. 

Lahden ammattikorkeakoulun avoimen datan palvelussa sovelletaan Creative Commons Nimeä 4.0 Kansainvälinen -lisenssiä (CC BY 4.0). Lisenssi koskee avoimen datan verkkopalvelussa olevia Lahden ammattikorkeakoulun tietoaineistoja.

Lisenssi Creative Commons Attribution 4.0  

Kuva
Business-kuva

Rekisteröityminen

Lahden ammattikorkeakoulun avoimen datan palvelun käyttö vaatii rekisteröitymisen LAMK data -portaalin (https://data.lamk.fi) kautta. Rekisteröitymisen käsittelyn jälkeen toimitetaan sähköpostiin henkilökohtainen API-avain, jolla pääsee käsiksi Lahden ammattikorkeakoulun avoimen datan tietoaineistoon.

Hakijan on luettava käyttöehdot, jotka hyväksytään rekisteröitymällä.

Kuva
KIRA-digi

Avoin digikampus - Open DigiCampus

LAMK Avoin data -portaali on toteutettu Avoin digikampus -hankkeessa.