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¶m2=verdi
Alle tjenestene returnerer JSON.
Følgende tjenester eksisterer:
- Hent undervisning for en student
- Hent eksamener for en student
- Hent studieprogram for en student
- Hent aktive emner
- Hent undervisningsaktiviteter
- Oppdater undervisningsaktiviteter fra TP
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. |