REST rajapinnat

Yleistä

Rajapintoja kutsutaan käyttämällä GET ja POST metodeja riippuen kohteesta. Mahdolliset parametrit annetaan aina JSON muodossa POST kutsuissa.

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