Spørretjenesten
Fra GrepWiki
(→Dokumentasjon) |
(→Eksisterende grensesnitt) |
||
Linje 2: | Linje 2: | ||
== Eksisterende grensesnitt == | == Eksisterende grensesnitt == | ||
- | Grep-data kan hentes via våre ulike endpoints. Det er flere formater å velge mellom: i dag kan data leveres som xtm, xml og json. Lister(REST) leveres som regel som json, xml eller atom. Læreplaner leveres også som odf, pdf, doc og rtf. | + | Grep-data kan hentes via våre ulike tjenester, som hver har sine adresser (endpoints). Det er flere formater å velge mellom: i dag kan data leveres som xtm, xml og json. Lister(REST) leveres som regel som json, xml eller atom. Læreplaner leveres også som odf, pdf, doc og rtf. |
=== Adresser (endpoints)=== | === Adresser (endpoints)=== |
Revisjonen fra 26. jan 2016 kl. 09:56
Direktoratet tilbyr i dag grensesnitt for spørringer på deler av databasen.
Innhold |
Eksisterende grensesnitt
Grep-data kan hentes via våre ulike tjenester, som hver har sine adresser (endpoints). Det er flere formater å velge mellom: i dag kan data leveres som xtm, xml og json. Lister(REST) leveres som regel som json, xml eller atom. Læreplaner leveres også som odf, pdf, doc og rtf.
Adresser (endpoints)
- Soap: http://data.udir.no/kl06/soap?wsdl
- REST: http://data.udir.no/kl06/<kode>.<format>
- OData: http://data.udir.no/kl06/odata/
Dokumentasjon
- Brukermanual for alle tjenestene: brukermanual for spørretjenesten
- Oversikt over SOAP-tjenesten, med beskrivelse av metoder og typer: http://data.udir.no/kl06/soap
Oversikt over tilgjengelige elementer
Følgende data kan hentes via spørretjenesten:
Tilgjengelig i 2013/04-versjonen:
- Liste over læreplaner
- Hver enkelt læreplan (inkl. tilhørende hovedområder, etc)
- Liste over fagkoder
- Hvert enkelt fagkode (inkl. tilhørende vurderingsordninger, etc)
- Liste over utdanningsprogram
- Hvert enkelt utdanningsprogram
- Liste over programområder
- Hvert enkelt programområde
- Liste over merknader
- Hver enkelt fag- og vitnemålsmerknad
- Liste over merkelapper
- Hver enkelt merkelapp
- Liste over kompetansemål
- Hvert enkelt kompetansemål
- Liste over fagkategorier
- Hver enkel fagkategori
- Liste over fagområder
- Hvert enkelt fagområde
Nytt i 2013/11-versjonen ( Alle endringer i spørretjenesten for kontrakt 2013/11):
- Liste over opplæringsfag
- Hvert enkelt opplæringsfag
- Mindre informasjon i refererte elementer
- Liste over årstrinn
- Hvert enkelt årstrinn
- Mulighet til å velge språk
- Mulighet til å hente forrige versjon av datafilene i REST/Odata
Se forøvrig brukermanual for spørretjenesten for ytterligere beskrivelse av elementene og hvordan du velger språk eller versjon.
Vi har også laget en versjon av wsdl (beskrivelse av soap api) myntet på mennesker, med kommentarer til felter, m.v., som kan være til hjelp for å få oversikt over de forskjellige datatypene og feltene: http://data.udir.no/kl06/soap
Under utvikling
- Eget SPARQL-endpoint(under testing)
- Direkteoppslag hovedområder
- Direkteoppslag kompetansemålsett
- Periodeangivelse i koblinger; gitt fagkode eller programområde, vis relevante lenker for et gitt tidspunkt.
Eldre grensesnitt som er faset ut
Fagkoder (stengt 22. april 2013)
Webservice (SOAP/XML)
http://lkt.udir.no/eksport/fagkoder.asmx
Denne tjenesten ble i sin tid utviklet for PAS/PGS, men hadde en del begrensninger og ytelsesproblemer, og ble lagt ned i april 2013. En bedre løsning for fagkoder ble lagt ut våren 2012, som en del av det nye grensesnittet for spørringer (se http://data.udir.no/kl06/fagkoder.xml eller http://data.udir.no/kl06/soap?wsdl).
Kompetansemål (stengt 22. april 2013)
Feed/filer (ATOM/RDF)
http://lkt.udir.no/Eksport/rdf.mvc/laereplan
Kompetansemål, presentert per læreplan. Leveret som ATOM-feed med liste over læreplaner, hver læreplan presentert som RDF/XML. Hver fil representerte struktur for kompetansemålene i læreplanen, inkludert navn på hovedområder og årstrinn, men ikke tekstlig innhold, og få knytninger mot øvrig læreplanverk.
Denne tjenesten hadde en del begrensninger og vi la den i april 2013.