REST-grensesnittet

I tabellen nedenfor har vi listet opp hvilke URLer du kan bruke for å hente ut de ulike elementene. REST-grensesnittet støtter en rekke ulike formater. Om du vil bruke et annet format enn standardformatet (JSON), oppgir du dette ved å legge på {.format} på slutten av URLen. Eksempelvis for å liste ut alle fag i xml-format, oppgir du http://data.udir.no/kl06/fagkoder.xml.

Versjonering

Ved oppgraderinger og endringer i KL06-tjenestene så kan innholdet endre struktur og form. Disse vil tre i kraft umiddelbart etter oppgradering. Om man ønsker å være sikret på at innholdet forblir det samme inntil man får oppdatert sine egne systemer, kan man be om data under en spesifikk versjon. KL06 støtter per nå to versjoner – den nyeste og nest nyeste.

For å indikere at man ønsker data fra en spesifikk versjon, angir man et query-parameter versjon med et spesifikt versjonsnummer.

Eksempelvis kan man spesifisere http://data.udir.no/kl06/laereplaner?versjon=http://psi.udir.no/kl06/2013/11 for å være sikker på at man henter ut data med den strukturen som er/var aktuell for den versjonen. Dette parameteret fungerer på alle kall.

Språkvalg i rest

Det er mulig å velge ut tekster på et bestemt språk ved å legge inn {?lang=xxx}. Der språket angis i henhold til ISO 639-2 standarden. http://data.udir.no/kl06/MAT1-04?lang=nno vil gi deg den gitte læreplanen med kun nynorske tekster. Dersom det ikke finnes oversettelser på dette språket vil tekstfeltene vises som tom liste.

Dersom en ikke angir noe språk vil en få ut alle tilgjengelige oversettelser for angitt element. Eks. http://data.udir.no/kl06/MAT1-03. Dersom en vil hente ut elementet på «hovedspråk», som i hovedsak variere mellom nynorsk og bokmål, setter en lang=default. Eks. http://data.udir.no/kl06/MAT1-03?lang=default vil vise MAT1-03 på nynorsk.