Timeplanlegging for UiO

Her beskrives resttjenestene for timeplanlegging for UiO.

Status

Under utvikling. Løpende dialog med UiO.

TjenesteURL'er

Her angis rot-url'er. I beskrivelsen av tjenestene står resten av URL'en.

For test: https://fs-test.uio.no/fsrest/rest/studrapp/
For prod: https://fsws.usit.no/fsrest/rest/studrapp/

Tjenestebeskrivelser

Denne tjenesten har kun et GET-grensesnitt. Der det er spesifisert "Query-parametre", så spesifiseres dette på følgende måte: http://url?param1=verdi&param2=verdi

Alle tjenestene returnerer JSON.

Følgende tjenester eksisterer:

Navn: Hent undervisning for en student
Beskrivelse: Denne tjenesten henter ut oversikt over undervisning for en student i et gitt semester
Rolle: studrapp-user
Type kall: GET
URL: undervisning
Parametre: Query-parametre:
brukernavn: Brukernavnet til studenten
arstall: Semesterets årstall
terminkode: Semesterets forbokstav (H/V)
Retur: JSON (Schema)

Navn: Hent eksamener for en student
Beskrivelse: Denne tjenesten henter ut oversikt over eksamner for en student i et gitt semester
Rolle: studrapp-user
Type kall: GET
URL: eksamen
Parametre: Query-parametre:
brukernavn: Brukernavnet til studenten
arstall: Semesterets årstall
terminkode: Semesterets forbokstav (H/V)
Retur: JSON (Schema)

Navn: Hent studieprogram for en student
Beskrivelse: Denne tjenesten henter ut informasjon om en students studieprogram.
Rolle: studrapp-user
Type kall: GET
URL: studieprogram
Parametre: Query-parametre:
brukernavn: Brukernavnet til studenten
Retur: JSON (Schema)

Navn: Hent aktive emner for ett semester
Beskrivelse: Denne tjenesten henter ut informasjon om alle aktive emner et gitt semester
Rolle: studrapp-user
Type kall: GET
URL: aktiveemner
Parametre: Query-parametre:
arstall: Året, fire siffer
terminkode: Semesterets forbokstav (H/V)
Retur: JSON (Schema)

 

Navn: Hent undervisningsaktiviteter for ett emne
Beskrivelse: Denne tjenesten henter ut informasjon om alle undervisningsaktivitetene i et emne, et gitt semester
Rolle: studrapp-user
Type kall: GET
URL: undervisningsaktiviteter
Parametre: Query-parametre:
arstall: Året, fire siffer
terminkode: Semesterets forbokstav (H/V)
emnekode: Emnekoden, case-sensitive
Retur: JSON (Schema)

 

Navn: Oppdater undervisningsaktiviteter fra TP
Beskrivelse: Denne tjenesten henter informasjon fra TP om undervisningsaktiviteter knyttet til et emne og oppdaterer undervisningstimeplanene i FS med informasjonen fra TP.
Rolle: studrapp-user
Type kall: POST
URL: oppdater_undervisningsaktiviteter
Parametre: Form-parametre:
arstall: Året, fire siffer
terminkode: Semesteret i blokkbokstaver ("VÅR", "HØST"). Dersom "h" eller "v" sendes inn som terminkode, blir dette tolket som hhv. "HØST" og "VÅR".
emnekode: Emnekoden, case-sensitive
Retur: JSON (Schema)
Mulige feilmeldinger: 400: "Kombinasjonen årstall, terminkode og emnekode finnes ikke for noen undervisningsaktiviteter i FS.": Det finnes ingen undervisningsaktiviteter i FS med denne kombinasjonen. Det kan hende du f.eks. har skrevet emnekoden feil.
Av Kine V. Lund
Publisert 1. apr. 2014 14:00 - Sist endret 18. feb. 2021 13:34