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 (label), 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_Codelijst

Deze query toont code, naam, definitie en bijbehorende persistente identifier van alle codes in een codelijst op basis van de identifier (uri) van die codelijst.

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, naam, versie, opmerking, onderdeel, leergebied, uitgever, vaardigheidsschaal, verplichte/optionele afname- en referentiescoretypes en persistente identifier (uri).

Recent toevoegingen in januari 2019:

  • De volgende kenmerken per toets: versie, opmerking en vaardigheidsschaal
  • Per toets-kenmerk leergebied en uitgever een unieke id per unieke waarde
  • Het toets-kenmerk onderdeelTF dat aangeeft of de toets een onderdeel van een andere toets is (true) of niet (false).
  • Het toets-kenmerk onderdeel_van dat verwijst naar de toets waar de toets onderdeel van is (Indien toets een onderdeel is)

voorbeeld:

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

oso_Toetscodelijst_NieuwsteCodes

Deze query toont de kenmerken van alle nieuwe toetsen in de meest recente publicatie van de OSO toetscodelijst. Deze kenmerken per toets zijn: toetscode, naam, versie, opmerking, leergebied, uitgever en persistente identifier (uri).

Deze query is januari 2019 toegevoegd.

voorbeeld:

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


oso_Toetscodelijst_VervallenCodes

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, naam, versie, opmerking, leergebied, uitgever en persistente identifier (uri).

Deze query is januari 2019 toegevoegd.

voorbeeld:

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



oso_ToetsscoreDetails

Deze query geeft een overzicht van de afname- en referentiescores (verplicht en optioneel) van een specifieke toets van OSO toetscodelijst. Het overzicht omvat naast de toetscode en id (uri) van de toets de volgende score-kenmerken: score_soort, scoretype_tekst (per score_soort) en 3 scoretype-kenmerken. De 3 scoretype-kenmerken zijn: id, waarde en toelichting per scoretype.

Deze query is januari 2019 toegevoegd.

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_Codelijst?api_key=geheim&id=<http://purl.edustandaard.nl/concept/0bc1d80a-3788-4e42-81b1-682a190f57c7>