Mer om UiO-FS-API

UiO-FS-API er et API utviklet av UiO for å imøtekomme de manglende funksjonalitetene som er i de nåværende FS-API-ene. Dette gjøres mulig ved å gjøre SQL-spørringer direkte mot FS-databasen.

Dette er en oversikt over hva man kan få ut av i API-et i dag, men det er lagt opp til at det kan utvides etter behov. 

Emne

I dag er det mulig å få ut all informasjon fra disse tabellene, gitt emnekode.

  • emne 
  • undtermin_emne
  • infotermin_emne
  • vurdkomtid

Utover dette er det

  • Fra tabellen emneinfo hentes følgende felter, gitt emnekode, år og terminkode
    • emnekode
    • versjonskode
    • infotypekode
    • sprakkode
    • infotekst_orginal
  • Endepunkt for å få ut emneoverlapp for et gitt emne.
  • Endepunkt for å få ut all informasjon gitt over i et og samme kall. 
  • Endepunkt for å få ut alle undervisningsterminer gitt år og terminkode

Eksamen

  • All informasjon fra tabellen kommisjon hentes ut gitt årstall og terminkode. 
    • Her er det en join av tabellene vurdkomenhet, vurderingskombinasjon og vuderingstid
    •  
  • Kommisjonsdeltagere hentes ut gitt emnekode, årstall, terminkode, versjonkode, kommisjonslopenr og vurdkombkode. 

    • Her får man da ut brukernavn og sensorkollekode.

Veiledning

  • All informasjon fra tabellen veiledningsforhold, gitt brukernavn på veileder og start- og sluttdato. 

Undervisning

I dag er det mulig å få ut all informasjon fra disse tabellene, gitt emnekode.

  • undervisningsenhet
  • emne_opptakgruppe
  • undaktivitet

Versjonskode er satt til 1, men man kan gi inn en annen verdi for å overstyre den. 

For disse tabellene er det også mulig å opprette en ny rad. I tillegg er det for undaktivitet og undervisningsenhet mulig å endre på en eksisterende rad. 

All dokumentasjon av parametre som kan gis inn til endepunktene er tilgjengelig i Gravitee.

Utbedring av API-et

Dersom ønsket funksjonalitet ikke er tilstedet i dagens API er det mulig å komme med forespørsler. Disse kan henvendes til usit-int@rt.uio.no.

Teknisk

Tjenesten bruker python pakken oracledb for å komme i kontakt med FS-databasen og er et REST-API bygget på FastAPI.

 

 

Publisert 22. nov. 2023 15:45 - Sist endret 21. juni 2024 14:42