Institusjonsregisteret

Denne tjenesten vil bli avviklet etter 31.03.2027. Bruk FS GraphQL API i stedet.

Eksisterer som REST-tjeneste. Her beskrives REST-tjenestene. Tjenester for å hente ut en spesifikk institusjon eller institusjoner basert på Query-parametre.

For å kunne bruke institusjonsregisteret, trengs ingen autentisering.

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/fskoder/
For prod: https://fsws.usit.no/fsrest/rest/fskoder/

Tjenestebeskrivelser

GET-grensesnitt

Der det er spesifisert "Query-parametre", så spesifiseres dette på følgende måte: http://url/?param1=verdi&param2=verdi

Begge tjenestene returnerer JSON.

Tjenestene

Følgende tjenester eksisterer:

Navn:Hent institusjon
Beskrivelse:Denne tjenesten henter ut institusjonsinfo basert på inst. nr.
Rolle:ingen
Type kall:GET
URL:institusjon/{instnr}
Parametre:PathParametere:
instnr: Institusjonsnummeret, f.eks. '185'.
Retur:JSON Schema

 

Navn:Hent institusjoner
Beskrivelse:Denne tjenesten henter ut institusjoner filtrert på institusjonstype (INSTITUSJONSTYPEKODE) og dato siste endret
Rolle:ingen
Type kall:GET
URL:institusjoner
Parametre:Query-parametere:
type: Type institusjon, INSTITUSJONSTYPEKODE, feks 'UNIV'. Dersom tom verdi, 'type=' eller dersom parameteren er utelatt, vil da spørringen hente info om alle institusjoner, uavhengig av type.
endringerSiden:  Dato sist endret, epoch unix time, Millisekunder siden 1.1.1970
Retur:JSON Schema
Publisert 6. apr. 2018 09:47 - Sist endret 23. mars 2026 10:03