Eduterm:Zoekopdrachten

Uit Kennisnet Developers Documentatie
Versie door Muskee01 (overleg | bijdragen) op 7 mei 2018 om 18:54 (add eckdt queries)
Naar navigatie springen Naar zoeken springen

Eduterm-symbol.png Eduterm: Zoekopdrachten

Op deze pagina staat een overzicht van alle zoekopdrachten voor publiek gebruik.

Info.gif Let wel, voor toegang is wel een API key nodig.

Query Releases

Voor elke query kunnen er 1-3 varianten bestaan. Een "latest" rolling-release query en 2 static queries. In principe werken alle klanten op de rolling release tenzij ze dit expliciet aanvragen voor een query.

type voorbeeld release verwijdering
latest, rolling Kerndoelen 2 weken na release nieuwe query niet
nieuw Kerndoelen20150901 wanneer de query inhoudelijk is aangepast en door ons getest niet, pas wanneer deze variant de status "oud" krijgt
oud Kerndoelen20150101 wanneer een nieuwe query wordt gereleased 3 maanden na release van een nieuwe query

Kernprogramma

Obkapi-relaties-tussen-queries.png

Onderwijsniveaus

Geeft alle onderwijsniveau's met de bijbehorende parent relatie.

voorbeeld:

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

VakLeergebieden

Geeft de vakken bij een bepaald onderwijsniveau.

parameters:

naam beschrijving voorbeeldwaarde
onderwijsniveau Geeft het onderwijsniveau waarvan de vakken opgevraagd worden. bk:78f5cabe-6649-4dc3-84bf-36d82c6c2d31 (Havo 1)

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/VakLeergebieden?api_key=geheim&onderwijsniveau=bk:78f5cabe-6649-4dc3-84bf-36d82c6c2d31

Vakkernen

Geeft de vakkernen van een bepaald vak bij een bepaald onderwijsniveau.

parameters:

naam beschrijving voorbeeldwaarde
onderwijsniveau Geeft het onderwijsniveau waarvan de vakken opgevraagd worden. bk:78f5cabe-6649-4dc3-84bf-36d82c6c2d31 (Havo 1)
vak Geeft het vak waarvan de vakkernen worden opgevraagd. bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0 (Wiskunde)

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/Vakkernen?api_key=geheim&onderwijsniveau=bk:78f5cabe-6649-4dc3-84bf-36d82c6c2d31&vak=bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0

Subkernen

Geeft de subkernen van een bepaalde vakkern binnen een bepaald vak bij een bepaald onderwijsniveau.

parameters:

naam beschrijving voorbeeldwaarde
onderwijsniveau Geeft het onderwijsniveau waarvan de vakken opgevraagd worden. bk:e05b5eb1-6a65-4f45-9556-79b25cd91da8 (SBO)
vak Geeft het vak waarvan de vakkernen worden opgevraagd. bk:c001f86a-4f8f-4420-bd78-381c615ecedc (Aardrijkskunde)
vakkern Geeft de vakkern waarvoor de subkernen worden opgevraagd. bk:aa2f68ba-69e5-415d-8d9b-8d6ab98942b1 (Burgerschap)

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/Subkernen?api_key=geheim&onderwijsniveau=bk:e05b5eb1-6a65-4f45-9556-79b25cd91da8&vak=bk:c001f86a-4f8f-4420-bd78-381c615ecedc&vakkern=bk:aa2f68ba-69e5-415d-8d9b-8d6ab98942b1

Vakinhouden

Deze query geeft de vakinhouden van een bepaalde subkern (parameter 4), binnen een bepaalde vakkern (parameter 3) binnen een bepaald kernprogramma. Het kernprogramma wordt bepaald door het vak/leergebied (parameter 2) en het niveau (parameter 1).

parameters:

naam beschrijving voorbeeldwaarde
onderwijsniveau Het niveau van het kernprogramma van de gevraagde vakinhouden. bk:78f5cabe-6649-4dc3-84bf-36d82c6c2d31 (Havo 1)
vak Het vak van het kernprogramma van de gevraagde vakinhouden. bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0 (Wiskunde)
vakkern De vakkern binnen het kernprogramma van de gevraagde vakinhouden. bk:dced6368-c076-4d51-8d83-53e9a87bef40 (Getallen en variabelen)
subkern De subkern binnen het kernprogramma van de gevraagde vakinhouden. bk:ea7b2da3-82bd-400c-aea0-59f39532dda2 (Getallen, getalsystemen en -relaties)

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/Vakinhouden?api_key=geheim&onderwijsniveau=bk:78f5cabe-6649-4dc3-84bf-36d82c6c2d31&vak=bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0&vakkern=bk:dced6368-c076-4d51-8d83-53e9a87bef40&subkern=bk:ea7b2da3-82bd-400c-aea0-59f39532dda2

Kerndoelen

Geeft bij een onderwijsniveau (parameter 1) de bijbehorende kerndoelen. Dit onderwijsniveau mag algemeen (bv. 'VO') zijn, maar ook specifiek (bv. 'VMBO Theoretische leerweg 1).

parameters:

naam beschrijving voorbeeldwaarde
onderwijsniveau Geeft het onderwijsniveau waarvan de vakken opgevraagd worden. bk:78f5cabe-6649-4dc3-84bf-36d82c6c2d31 (Havo 1)

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/Kerndoelen?api_key=geheim&onderwijsniveau=bk:78f5cabe-6649-4dc3-84bf-36d82c6c2d31

Einddoelen

Deze query geeft de einddoelen weer. Einddoelen kunnen zowel Eindtermen (bovenbouw) zijn, als Tussendoelen (onderbouw). De parameters zijn Onderwijsniveau, Vak, Vakkern en Subkern (zie de betreffende queries). Een einddoel hangt onderaan een subkern (3e niveau), of aan een vakinhoud (4e niveau). In geval van het laatste is deze ook weergegeven.

parameters:

naam beschrijving voorbeeldwaarde
onderwijsniveau Het niveau van het kernprogramma van de gevraagde einddoelen. bk:ac188375-0a1a-4984-ac80-14d04a086a19 (Vwo 1)
vak Het vak van het kernprogramma van de gevraagde einddoelen. bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0 (Wiskunde)
vakkern De vakkern binnen het kernprogramma van de gevraagde einddoelen. bk:dced6368-c076-4d51-8d83-53e9a87bef40 (Getallen en variabelen)
subkern De subkern binnen het kernprogramma van de gevraagde einddoelen. bk:ea7b2da3-82bd-400c-aea0-59f39532dda2 (Getallen, getalsystemen en -relaties)

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/Einddoelen?api_key=geheim&onderwijsniveau=bk:ac188375-0a1a-4984-ac80-14d04a086a19&vak=bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0&vakkern=bk:dced6368-c076-4d51-8d83-53e9a87bef40&subkern=bk:ea7b2da3-82bd-400c-aea0-59f39532dda2

KernprogrammaNiveauVak

Deze query geeft het kernprogramma weer voor een bepaald niveau en een bepaald vak. In de resultaten wordt de volledige opbouw van dit vak (van Vakleergebieden tot Einddoelen) weergegeven.

parameters:

naam beschrijving voorbeeldwaarde
onderwijsniveau Het niveau van het kernprogramma van de gevraagde einddoelen. bk:ac188375-0a1a-4984-ac80-14d04a086a19 (Vwo 1)
vak Het vak van het kernprogramma van de gevraagde einddoelen. bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0 (Wiskunde)

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/KernprogrammaNiveauVak?api_key=geheim&onderwijsniveau=bk:ac188375-0a1a-4984-ac80-14d04a086a19&vak=bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0

KerndoelenBijEinddoel

Geeft de kerndoelen weer gegeven een onderwijsniveau (parameter 1) en een pad van Vak-Vakkern-Subkern-Einddoel (parameter 2 t/m 4). Kerndoelen horen alleen bij de onderbouw, waar de einddoelen feitelijk tussendoelen heten.

parameters:

naam beschrijving voorbeeldwaarde
onderwijsniveau Het niveau van het kernprogramma van de gevraagde kerndoelen. bk:eaa0c07f-193e-4be5-8dc6-a00bbfc7a446 (Havo 1)
vak Het vak van het kernprogramma van de gevraagde kerndoelen. bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0 (Engels)
vakkern De vakkern binnen het kernprogramma van de gevraagde kerndoelen. bk:ee274481-3a9f-4799-9f41-4b1d80b42b65 (Gesprekken voeren)
subkern De subkern binnen het kernprogramma van de gevraagde kerndoelen. bk:b74ac03b-d0f5-48fd-8753-58539f737770 (Informatie uitwisselen)
einddoel Het einddoel binnen het kernprogramma van de gevraagde kerndoelen. bk:a38ffdc5-0ead-4b17-920a-a1fe2ad48c24 (Eenvoudige feitelijke informatie achterhalen ...)

voorbeeld:

https://api.onderwijsbegrippen.kennisnet.nl/1.0/Query/Einddoelen?api_key=geheim&onderwijsniveau=bk:eaa0c07f-193e-4be5-8dc6-a00bbfc7a446&vak=bk:7afbb7a6-c29b-425c-9c59-6f79c845f5f0&vakkern=bk:ee274481-3a9f-4799-9f41-4b1d80b42b65&subkern=bk:b74ac03b-d0f5-48fd-8753-58539f737770&einddoel=bk:a38ffdc5-0ead-4b17-920a-a1fe2ad48c24