Eduterm:Zoekopdrachten/OSO

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen

Codelijsten uit de standaard OSO

oso_Codelijsten

Deze query zoekt naar alle codelijsten en geeft Nummer (nr), Naam, URI (id), Geldig-vanaf-datum (geldigvanaf), Geldig-tot-datum (geldigtot), Wijzigingsdatum en Wijzigingshistorie (wijzigingen) van die codelijsten terug.

Maart 2019 zijn de volgende kernmerken per codelijst aan de resultaten toegevoegd: Geldig-vanaf-datum (geldigvanaf), Geldig-tot-datum (geldigtot), Wijzigingsdatum en Wijzigingshistorie (wijzigingen).

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Codelijsten?api_key=geheim

oso_CodelijstenNuActueel

Deze query zoekt naar alle codelijsten die nu actueel zijn. Het geeft Nummer (nr), Naam, URI (id), Geldig-vanaf-datum (geldigvanaf), Geldig-tot-datum (geldigtot) en Wijzigingsdatum van die codelijsten terug.

Maart 2019 is deze nieuwe query toegevoegd.

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_CodelijstenNuActueel?api_key=geheim

oso_Codelijst

Deze query toont Code, Naam, Definitie, Geldig-vanaf-datum (geldigvanaf), Geldig-tot-datum (geldigtot), Wijzigingsdatum en URI (id) van alle codes in een codelijst op basis van de identifier (uri) van die codelijst.

Maart 2019 zijn de volgende kernmerken per code aan de resultaten toegevoegd: Geldig-vanaf-datum (geldigvanaf), Geldig-tot-datum (geldigtot) en Wijzigingsdatum.

parameters:

naam beschrijving voorbeeldwaarde
id identifier van codelijst <http://purl.edustandaard.nl/concept/f4852975-cee4-4075-be44-ce97e55ed197>

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Codelijst?api_key=geheim&id=<http://purl.edustandaard.nl/concept/f4852975-cee4-4075-be44-ce97e55ed197>

oso_CodelijstNr

Deze query toont de kenmerken van alle codes in een codelijst op basis van het nummer van die codelijst. Deze kenmerken zijn per code: code, naam, definitie en identifier (uri).

parameters:

naam beschrijving voorbeeldwaarde
nr nummer van codelijst 23

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_CodelijstNr?api_key=geheim&nr=23

oso_Toetscodelijst

Deze query toont de kenmerken van alle toetsen op de OSO toetscodelijst. Deze kenmerken per toets zijn: Toetscode (code), Naam, Versie, Opmerking, Geldig-vanaf-datum (geldigvanaf), Geldig-tot-datum (geldigtot), Wijzigingen, Wijzigingsdatum, Onderdeel-JaNee ("Ja" of "Nee" in onderdeel), Onderdeel-TrueFalse (True of False in onderdeelTF), Onderdeel-van, Leergebied, Uitgever (naam en id), Vaardigheidsschaal, Detailsscores en URI (id). Indien dit een toetsonderdeel betreft bevat Onderdeel-van een verwijzing naar (de URI van) de bovenliggende toets waarvan deze toets onderdeel is. De detailscores omvatten de Verplichte afnamescores (afnamescores_verplicht), Optionele afnamescores (afnamescores_optioneel), Verplichte referentiescores (referentiescores_verplicht), Optionele referentiescores (referentiescores_optioneel)

Maart 2019 zijn de volgende kernmerken per toets/toetscode aan de resultaten toegevoegd: Geldig-vanaf-datum (geldigvanaf), Geldig-tot-datum (geldigtot), Wijzigingen en Wijzigingsdatum.

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Toetscodelijst?api_key=geheim

oso_Toetscodelijst_GewijzigdeCodesSinds

Geeft een overzicht van de toetsen (toetscodes) in OSO toetscodelijst die sinds een bepaalde datum toegevoegd en/of gewijzigd zijn. De kenmerken zijn per toets (toetcode): Code, Naam, Versie, Opmerking, Geldig-vanaf-datum (geldigvanaf), Geldig-tot-datum (geldigtot), Wijzigingen, Wijzigingsdatum, Leergebied, Uitgever en URI (id).

Maart 2019 is deze nieuwe query toegevoegd.

parameters:

naam beschrijving voorbeeldwaarde
datum datum vanaf wanneer de wijzigingen getoond moeten "2018-10-31"

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Toetscodelijst_GewijzigdeCodesSinds?api_key=geheim&datum="2018-10-31"

oso_Toetscodelijst_NieuweCodesSinds

Geeft een overzicht van de toetsen (toetscodes) in OSO toetscodelijst die sinds een bepaalde datum toegevoegd zijn. De kenmerken zijn per toets (toetcode): Code, Naam, Versie, Opmerking, Geldig-vanaf-datum (geldigvanaf), Leergebied, Uitgever en URI (id).

Maart 2019 is deze nieuwe query toegevoegd.

parameters:

naam beschrijving voorbeeldwaarde
datum datum vanaf wanneer de nieuwe toetsen getoond moeten "2018-07-01"

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Toetscodelijst_NieuweCodesSinds?api_key=geheim&datum="2018-07-01"

oso_Toetscodelijst_NieuwsteCodes

Geeft een overzicht van de toetsen in OSO toetscodelijst die in de laatste paar publicaties (uiterlijk afgelopen jaar) aan de toetscodelijst toegevoegd zijn. De kenmerken per toets zijn: Toetscode (code), Naam, Versie, Opmerking, Geldig-vanaf-datum (gedligvanaf), Leergebied, Uitgever en URI (id).

Deze query is januari 2019 toegevoegd.

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Toetscodelijst_NieuwsteCodes?api_key=geheim

oso_Toetscodelijst_VerouderdeCodesSinds

Geeft een overzicht van de toetsen (toetscodes) in OSO toetscodelijst die sinds een bepaalde datum verouderd zijn. De kenmerken zijn per toets (toetcode): Code, Naam, Versie, Opmerking, Geldig-tot-datum (geldigtot), Leergebied, Uitgever en URI (id).

Deze query is maart 2019 toegevoegd.

parameters:

naam beschrijving voorbeeldwaarde
datum datum vanaf wanneer de toetscodes verouderd zijn, worden de toetscodes getoond "2016-01-01"

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Toetscodelijst_VerouderdeCodesSinds?api_key=geheim&datum="2016-01-01"

oso_Toetscodelijst_VerouderdeCodes

Deze query toont de kenmerken van alle toetsen die in de loop der jaren vervallen (verouderd) in de OSO toetscodelijst. Deze kenmerken per toets zijn: Toetscode (code), Naam, Versie, Opmerking, Geldig-tot-datum (geldigtot), Leergebied, Uitgever en URI (id).

Deze query is maart 2019 hernoemd (was "VervallenCodes").

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Toetscodelijst_VerouderdeCodes?api_key=geheim

oso_Toets_ScoreDetails

Deze query geeft een overzicht van de afname- en referentiescores (verplicht en optioneel) van een specifieke toets van de OSO toetscodelijst. Het overzicht omvat naast de Toetscode (code), URI (id), Naam en Versie van de toets de volgende score-kenmerken: Het Scoresoort (score_soort), Scoretype (scoretype_tekst bij score_soort) en 3 Scoretype-kenmerken.

De waarde voor Scoresoort is "Afnamescores_verplicht", "Afnamescores_optioneel", "Referentiescores_verplicht" of "Referentiescores_optioneel" voor de 4 varianten. Scoretype bevat de letterlijke tekst uit Excel-lijst uit de 4 Scoresoort-kolommen; voor afnamescores bestaat deze waarde uit een opsomming van items uit {VS,AG,TF,GF,AO}, voor referentiescores bestaat deze waarde uit een opsomming van items uit {DLE,AE,IV,Percentiel,AVI,etc.}. De 3 Scoretype-kenmerken zijn per gekoppelde scoretype: URI (id), Waarde en Toelichting; bijvoorbeeld <http://purl.edustandaard.nl/concept/fc0378da-ab0d-4966-a584-635f08d66d10>, "DLE" respectievelijk "Didactische Leeftijd Equivalent" .

Deze query is maart 2019 hernoemd.

parameters:

naam beschrijving voorbeeldwaarde
id identifier van codelijst <http://purl.edustandaard.nl/concept/0bc1d80a-3788-4e42-81b1-682a190f57c7>

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Toets_ScoreDetails?api_key=geheim&id=<http://purl.edustandaard.nl/concept/0bc1d80a-3788-4e42-81b1-682a190f57c7>

oso_Toetscode_ScoreDetails

Deze query geeft een overzicht van de afname- en referentiescores (verplicht en optioneel) van een specifieke toets van de OSO toetscodelijst op basis van de opgegeven toetscode.

Het resultaat omvat dezelfde informatie als bij voorgaande query oso_Toets_ScoreDetails.

Deze query is nieuw per maart 2019.

parameters:

naam beschrijving voorbeeldwaarde
toetscode code van toetscode "SVTTL2018_A_N60"

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/oso_Toetscode_ScoreDetails?api_key=geheim&toetscode="SVTTL2018_A_N60"