...
Haku on "AND" -haku kenttien välillä. Lista -tyyppiset parametrit ovat "OR" saman tyyppisen listan sisällä olevien elementtien välillä.
| Code Block | ||
|---|---|---|
| ||
{
"startDate": "2013-11-22T09:00",
"endDate": "2013-11-22T10:00",
"room": ["G201"]
} |
Vastaus
| Kenttä | Kuvaus |
|---|---|
| status | Tieto onnistuiko pyyntö vai oliko mahdollisia virheitä. "success", "warn", "error" |
| message | Mahdollinen tarkentava viesti esimerkiksi virhetilanteissa. |
| reservations | Lista varauksia. |
...
Anna hakuparametriksi ylhäällä kuvattu "Haku" -olion mukainen JSON. Jokin haun kentistä pitää olla määriteltynä jotta haku palauttaisi tuloksia.
| Code Block | ||
|---|---|---|
| ||
curl -u "metropolia_public:" -X POST http://opendata.metropolia.fi/r1/reservation/search -d '{
"startDate":"2013-11-22T09:00", "endDate":"2013-11-22T10:00", "room":["G201"]
}'
|
...
Huomaa että opintojaksototeutuksen varaukset voivat olla merkitty joko pelkästään opintojaksototeutukselle tai ryhmälle, tai sitten varauksella voi olla molemmat tiedot asetettuna.
Varauksiin tallennetaan yleensä sekä ryhmätieto että toteutus jota varaus koskee. Näinollen jos haluat kaikki tietyn ryhmän opetustapahtumat voit hakea pelkällä ryhmällä varauksia.
Esimerkiksi:
| Code Block | ||
|---|---|---|
| ||
# tiettujen toteutusten varausten haku
curl -u "metropolia_public:" -X POST http://opendata.metropolia.fi/r1/reservation/search -d '{
"realization":["SB00AA01-2000", "SB00AA03-2000", "SB00AA04-2000", "SB00AA06-2001"]
}'
# tietyn ryhmän varausten haku. Huomaa että et voi samassa pyynnössä hakea sekä tiettyjen toteutusten
# että ryhmien varauksia koska hakuehto eri tyyppisten kenttien välillä on AND
curl -u "metropolia_public:" -X POST http://opendata.metropolia.fi/r1/reservation/search -d '{
"student_group":["SB13K2"]
}' |
...
Alla oleva esimerkki hakee kaikki varaukset joiden alku-ajankohta on ennen klo 10.00, ja loppu-ajankohta on klo. 9.00 tai sen jälkeen.
| Code Block | ||
|---|---|---|
| ||
curl -u "metropolia_public:" -X POST http://opendata.metropolia.fi/r1/reservation/search -d '{
"rangeStart": "2013-11-22T09:00",
"rangeEnd": "2013-11-22T10:00",
"room": ["G201"]
}'
|
...
Jos haluat hakea esimerkiksi mitä opetusta on tiettynä ajankohtana, voit hakea varaukset jotka alkavat tietyn ajankohdan jälkeen. Vastaukesta voit kerätä yksilölliset opintojaksototeutukset ja luokkahuoneet joissa opetus järjestetään. Voit lisätä vielä hakuehdon rakennukselle jos haluat vain tietyn toimipisteen opetustapahtumat.
| Code Block | ||
|---|---|---|
| ||
curl -u "metropolia_public:" -X POST http://opendata.metropolia.fi/r1/reservation/search -d '{
"startDate": "2013-11-22T09:00",
"endDate": "2013-11-22T15:00",
"building": ["AGRICO"]
}'
|
...
| Code Block | ||
|---|---|---|
| ||
curl -u "metropolia_public:" http://opendata.metropolia.fi/r1/reservation/building/373 |
Esimerkki vastauksesta:
| Code Block | ||
|---|---|---|
| ||
{
"status": "success",
"building": {
"id": "373",
"type": "building",
"code": "Test",
"name": "Test Street 3 D",
"places": 0
},
"resources": [{
"id": "374",
"type": "room",
"code": "Testroom1",
"name": "ATK-luokka",
"resourceType": "ATK-luokka",
"description": "Vain testikäytössä oleva virtuaalinen tila, jolla ei ole fyysisessä maailmassa vastinetta.",
"places": 22
}, {
"id": "375",
"type": "room",
"code": "Testroom2",
"name": "Opetustila",
"resourceType": "Opetustila",
"description": "Vain testikäytössä oleva virtuaalinen tila, jolla ei ole fyysisessä maailmassa vastinetta.\r\n",
"places": 30
}]
}
|