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, 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, 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>