Yleistä
Rajapintoja kutsutaan käyttämällä GET ja POST metodeja riippuen kohteesta. Mahdolliset parametrit annetaan aina JSON muodossa POST kutsuissa.
Huomaa että koodi-esimerkit saattavat näkyä rivitettynä selaimessa. Jos maalaat alueen (tai tuplaklikkaat aluetta) niin saat tiedot kuitenkin oikein rivitettynä.
Kieleistys
Voit valita sisällön kielen (kieleistetyt kentät) antamalla halutun kielen otsikkotiedoissa tai "query parametrina". Oletuskieli on suomi (fi). Vaihtoehtoisesti voit pyytää sisällön kielellä englanti (en)
Esimerkiksi:
# Otsikkotiedoissa curl -u "metropolia_public:" -H "Accept-Language: en" http://opendata.metropolia.fi/r1/reservation/816121 # Query paramerina. Jos molemmat annettu niin query parametri yliajaa otsikkotiedoissa asetetun. curl -u "metropolia_public:" http://opendata.metropolia.fi/r1/reservation/816121?l=en
Päivämäärät
Päivämäärän muoto JSON:ssa on aina "yyyy-MM-dd'T'HH:mm" ellei muuta mainittu. Esimerkiksi "2020-12-31T13:30".
Autentikointi
Kaikkien kutsujen autentikointi toteutetaan antamalla api_key Basic Auth headereissa. Esimerkiksi curl käytettäessä voidaan käyttäjänimi antaa "-u" parametrilla. Kaksoispiste käyttäjänimen perässä estää curl:a pyytämästä salasanaa.
curl -u "metropolia_public:" http://opendata.metropolia.fi/r1/reservation/816121
Palvelut
Varauspalvelu. Tilojen ja opintojaksototeutusten varausten haku.