Data fra FS benyttes i en lang rekke andre systemer både ved UiB og hos tredjeparter utenfor institusjonen. Eksempler på dette er LMS (Canvas) og IAM (tilgang.uib.no). Felles for disse integrasjonene er at de henter data fra FS ved å benytte ulike endepunkt (webadresser/url'er) organisert i forskjellige API'er. Det finnes mange slike API'er og endepunkter mot FS.

I tillegg til at leverandøren av FS (SIKT) tilbyr API'er mot FS har vi på UiB også et lokalt utviklet API mot FS. I dette API'et har vi laget endepunkter når de nasjonale felles API'ene fra SIKT ikke gir tilstrekkelig funksjonalitet for våre behov.

API'er fra SIKT

API	Tilgjengelig i API GW	I bruk ved UiB	Kommentar
FS-API	JA	JA	Videreutvikles ikke
FSWS	JA	JA	Videreutvikles ikke. Inneholder blant annet tjenester som BAS, CDM, DIGEKS, Studinfo2
Gemini	JA	JA	Videreutvikles ikke
FS GraphQL	JA	JA

I tillegg kommer en del API'er som brukes internt i FS mellom FS-databasene og i kommunikasjon med andre offentlige tjenester som Digital postkasse, RUST, NOM-opptaket og EMREX. Mer info finnes her: https://www.fellesstudentsystem.no/brukersider/brukerdok/fswebservice

Lokalt utviklet API – FSFD

Vi kan sette opp rest-tjenester lokalt ved UiB. Vi ønsker i utgangspunktet å gjøre dette så sjeldent som mulig. Vi ønsker at integrasjoner med FS i størst mulig grad skal gjøres gjennom endepunkter som SIKT har ansvar for. Unntak fra dette gjøres når SIKT ikke er i stand til å levere det vi trenger av endepunkter innen rimelig tid. Det har lenge vært høy utviklingstakt når det gjelder systemer som trenger data fra FS ved UiB og SIKT har hittil ikke vært i stand til å kaste seg rundt i tilstrekkelig tempo og tilby integrasjonspunkter. Det er derfor laget lokale integrasjonspunkter for blant annet LMS (Canvas), ulike digitale skjema (DIGIFORMS), eksternweb, Fond- og legat, ph.d.-avhandlingsportal, robotisering m.m.

Lenker:

Administrasjonsgrensesnitt prod: https://fsredit.fd.uib.no/
Administrasjonsgrensesnitt demo: https://fstestredit.fd.uib.no/
Dokumentasjon av tjenestene (ofte noe mangelfullt): http://apidoc.app.uib.no/system/fs.html

Fellestjeneste for datadeling – Intark

Intark er en plattform som gjør arbeidet med deling av data enklere. Les mer om Intark her https://www.uninett.no/Intark eller ta IT-avdelingens digitale kurs om Integrasjonsarkitekturen ved UiB.

API-GW – Gateway

Som en del av Intark benytter UiB en api-gateway kalt Gravitee. Dette er vår API-portal. Gjennom portalen gjør vi tilgjengelig de api’ene som vi ønsker å eksponere for omverdenen. I portalen defineres ulike api’er (inkludert våre lokalt utviklede api’er) og såkalte «planer». De som har behov for å hente ut data fra FS kan registrere seg i portalen og der opprette en applikasjon. Gjennom applikasjonen bes det om tilgang på data gjennom en eller flere av disse planene – som da altså bestemmer hva slags data du får tilgang til.

Mer informasjon om Gravitee:

Gravitee: https://www.gravitee.io/
UiBs instans av Gravitee: https://api-uib.intark.uh-it.no/

Meldingskø

En annen viktig del av Intark er meldingssystemet. FS sender meldinger ut på en meldingskø når det skjer endringer i data på FS. Det kan f.eks. være når det opprettes en ny person eller et nytt emne eller når det gjøres endringer på data. Eksterne systemer kan da «konsumere» disse meldingene og agere på dem. F.eks. om det mottas en melding om at det er opprettet en ny person i FS, så kan det eksterne systemet gå til et endepunkt i api’et for å hente informasjon om denne personen.

MQ-Probe

MQ-Probe er en tjeneste som gir innsikt i meldinger som sendes fra ulike systemer ved UiB: https://mq-probe.app.uib.no/

RabbitMQ

RabbitMQ er et selvbetjeningssystem for applikasjonseiere hvor de kan få tilgang til meldingskøen.

Om tilgang til data

Det er et mål at alle tilganger til data skal administreres gjennom api-portalen. Det er ikke ennå laget et stringent og tydelig opplegg for hva slags «planer» som tilbys i portalen. Det gjør at det foreløpig kan være litt vanskelig orientere seg i portalen og vite hvilken plan en bør abonnere på. Det kan til og med tenkes at det ikke finnes en plan som gir tilgang til akkurat det som behøves i et gitt prosjekt/applikasjon/tjeneste. Om du har behov for data kan du derfor ta kontakt med FS-hjelp enten gjennom UiBHjelp eller på epost til fs-hjelp@uib.no, slik at vi kan ha en dialog om behov og løsning.

Åpne data

Det er et mål å gjøre data enkelt tilgengelig slik at data kan benyttes der det er behov for det. Som et ledd i dette gjøre vi tilgjengelig integrasjonspunkter til data som ikke behøver streng tilgangsregulering (såkalte åpne data). Den som ønsker å benytte slike data må likevel benytte api-portalen som beskrevet ovenfor. Ved at tilgang til også åpne data administreres gjennom api-portalen sørger vi for å ha verktøy som gir oss som systemforvaltere av FS oversikten over bruk av åpne data. Vi vil også ha mulighet til å begrense hvor mange oppslag brukere av åpne data kan gjøre f.eks. i timen, slik at ikke bruken går på bekostning av andre virksomhetskritiske integrasjoner mellom systemer på UiB. Om en har behov for data om f.eks. studieprogram og emner ved UiB kan de altså abonnere på planen kalt «Prod|Test: Open data from the FS-API» i tilknytning til api’et FSAPI i api-portalen.