Spørretjenesten

Fra GrepWiki

(Forskjell mellom revisjoner)
Gå til: navigasjon, søk
(Eldre grensesnitt som er faset ut)
Linje 2: Linje 2:
== Eksisterende grensesnitt ==
== Eksisterende grensesnitt ==
-
Grep-data kan hentes via både webservice/soap og REST. 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 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)===
-
* http://data.udir.no/kl06/soap?wsdl  
+
* Soap: http://data.udir.no/kl06/soap?wsdl  
-
* http://data.udir.no/kl06/<kode>.<format>  
+
* REST: http://data.udir.no/kl06/<kode>.<format>  
-
* http://data.udir.no/kl06/odata/
+
* OData: http://data.udir.no/kl06/odata/
 +
=== Dokumentasjon ===
 +
* Brukermanual for alle tjenestene: [[Medium:Brukermanual_for_Grep_soap_odata_rest.pdf | brukermanual for spørretjenesten]]
 +
* Oversikt over SOAP-tjenesten, med beskrivelse av felter: http://data.udir.no/kl06/soap
 +
 +
=== Oversikt over tilgjengelige elementer ===
Følgende data kan hentes via spørretjenesten:
Følgende data kan hentes via spørretjenesten:
 +
 +
Tilgjengelig i 2013/04-versjonen:
* Liste over læreplaner
* Liste over læreplaner
* Hver enkelt læreplan (inkl. tilhørende hovedområder, etc)
* Hver enkelt læreplan (inkl. tilhørende hovedområder, etc)
Linje 33: Linje 40:
* Hvert enkelt opplæringsfag
* Hvert enkelt opplæringsfag
* Mindre informasjon i refererte elementer
* Mindre informasjon i refererte elementer
 +
* Liste over årstrinn
 +
* Hvert enkelt årstrinn
* Mulighet til å velge språk
* Mulighet til å velge språk
* Mulighet til å hente forrige versjon av datafilene i REST/Odata
* Mulighet til å hente forrige versjon av datafilene i REST/Odata
-
Lagt til i patch 1. april 2014:
+
Se forøvrig [[Medium:Brukermanual_for_Grep_soap_odata_rest.pdf | brukermanual for spørretjenesten]] for ytterligere beskrivelse av elementene og hvordan du velger språk eller versjon.
-
* Liste over årstrinn
+
-
Lagt til i patch 19. januar 2015:
+
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
-
* Hvert enkelt årstrinn
+
-
 
+
== Under utvikling ==
-
Vi har laget en versjon av wsdl (beskrivelse av soap api) myntet på mennesker, med kommentarer til felter, m.v.: http://data.udir.no/kl06/soap
+
* Eget SPARQL-endpoint(under testing)
-
 
+
* Direkteoppslag hovedområder
-
Se forøvrig [[Medium:Brukermanual_for_Grep_soap_odata_rest.pdf | brukermanual for spørretjenesten]] for ytterligere dokumentasjon.
+
* Direkteoppslag kompetansemålsett
 +
* Periodeangivelse i koblinger; gitt fagkode eller programområde, vis relevante lenker for et gitt tidspunkt.
== Eldre grensesnitt som er faset ut ==
== Eldre grensesnitt som er faset ut ==
Linje 57: Linje 65:
http://lkt.udir.no/Eksport/rdf.mvc/laereplan<br/>
http://lkt.udir.no/Eksport/rdf.mvc/laereplan<br/>
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.<br/>Denne tjenesten hadde en del begrensninger og vi la den i april 2013.
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.<br/>Denne tjenesten hadde en del begrensninger og vi la den i april 2013.
-
 
-
== Under utvikling ==
 
-
'''Flere spørretjenester'''<br/>
 
-
 
-
''SPARQL''<br/>
 
-
* Eget endepunkt for RDF(under testing)
 
-
 
-
== Lenger frem ==
 
-
 
-
'''Flere spørretjenester'''<br/>
 
-
''Webservice/SOAP+REST''<br/>
 
-
Flere spørringer/oppslag etter samme modell som de nye spørringene på læreplan og fag.
 
-
 
-
* Direkteoppslag hovedområder
 
-
* Direkteoppslag kompetansemålsett
 

Revisjonen fra 26. jan 2016 kl. 09:41

Direktoratet tilbyr i dag grensesnitt for spørringer på deler av databasen.

Innhold

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.

Adresser (endpoints)

Dokumentasjon

Oversikt over tilgjengelige elementer

Følgende data kan hentes via spørretjenesten:

Tilgjengelig i 2013/04-versjonen:

Nytt i 2013/11-versjonen ( Alle endringer i spørretjenesten for kontrakt 2013/11):

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

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.

Personlige verktøy
Navnerom
Varianter
Handlinger
Navigasjon
Verktøy