OSR:Hoofdpagina: verschil tussen versies

Huidige versie van 20 mrt 2025 om 16:46

De voorziening Onderwijs Serviceregister (OSR) vervult de rol van “telefoonboek” voor de onderwijsketen.

In het OSR worden de relatie tussen scholen, leveranciers en diensten vastgelegd. Hiermee biedt het OSR een standaardoplossing omtrent routerings- en autorisatievraagstukken.
Het register kan door iedereen met een PKI-overheidscertificaat/ODOC certificaat worden geraadpleegd.

De volgende generieke user stories worden door de OSR API ondersteund:

1. Als API-gebruiker wil ik informatie over een onderwijsinstelling opvragen
Ophalen van schoolinformatie en bijbehorende bestuursinformatie. Hier kan specifiek gezocht worden naar een school.

2. Als API-gebruiker wil ik informatie over een dienst of dienstversie opvragen
Ophalen van informatie over een dienst of dienstversie. Hier kan specifiek gezocht worden op een (deel van) de dienstnaam.

3. Als API-gebruiker wil ik het mandaat van een systeem valideren
Verifiëren of de onderwijsinstelling een mandaat heeft afgegeven aan een systeem.

4. Als API-gebruiker wil ik een endpoint opvragen
Ophalen van endpoints van een onderwijsinstelling of routeringskenmerk voor een bepaalde dienstversie.

5. Als API-gebruiker wil ik een endpoint toevoegen of wijzigen
Endpoints aanmaken en wijzigen door een gemandateerd systeem.

Momenteel werken we aan een nieuwe versie van de API om ook mandateren op bestuursniveau mogelijk te maken.
Bekijk hier de veranderingen ten opzichte van de huidige versie.

OSR kwalificatie

Kwalificatie test plan OSR 2.2

Hotlinks

API documentatie
OSR Omgevingen
OSR Dienst versies

Security

Kennisnet standaarden rondom
beveiligd gegevenstransport.

Ondersteuning

Begrippenlijst
Veelgestelde vragen

@@ Regel 1: / Regel 1: @@
 __NOTOC__
-De voorziening Onderwijs Serviceregister (OSR) zal de rol van “telefoonboek” voor de onderwijsketen vervullen. <br>
-In het OSR worden de relatie tussen scholen, leveranciers en diensten vastgelegd. Hiermee zal het OSR een standaardoplossing bieden omtrent routerings- en autorisatievraagstukken. <br>
-Het register kan door iedereen met een PKI-overheidscertificaat worden geraadpleegd.<br><br>
-De volgende services worden door het OSR aangeboden: <br>
+{|
+|- style="vertical-align:top"
+| De voorziening Onderwijs Serviceregister (OSR) vervult de rol van “telefoonboek” voor de onderwijsketen. <br>
+In het OSR worden de relatie tussen scholen, leveranciers en diensten vastgelegd. Hiermee biedt het OSR een standaardoplossing omtrent routerings- en autorisatievraagstukken. <br>
+Het register kan door iedereen met een PKI-overheidscertificaat/ODOC certificaat worden geraadpleegd.<br><br>
-[[OSR:2019/Opvragen_onderwijsinstelling|Opvragen onderwijsinstelling]]<br>
+De volgende generieke user stories worden door de OSR API ondersteund:<br>
+[[OSR:API/V2/Opvragen_informatie_over_onderwijsinstelling|1. Als API-gebruiker wil ik informatie over een onderwijsinstelling opvragen]]<br>
 Ophalen van schoolinformatie en bijbehorende bestuursinformatie. Hier kan specifiek gezocht worden naar een school.<br>
-[[OSR:2019/Opvragen_mandaten|Opvragen mandaten]]<br>
+[[OSR:API/V2/Opvragen_informatie_over_dienst|2. Als API-gebruiker wil ik informatie over een dienst of dienstversie opvragen]]<br>
-Voordat een leverancier een endpoint kan aanmaken voor de dienst en onderwijsinstelling, is het nodig om te verifiëren of de onderwijsinstelling een mandaat heeft aangemaakt voor de leverancier.<br>
+Ophalen van informatie over een dienst of dienstversie. Hier kan specifiek gezocht worden op een (deel van) de dienstnaam.<br>
-[[OSR:2019/Opvragen_endpoints|Opvragen endpoints]]<br>
+[[OSR:API/V2/Valideren_mandaat|3. Als API-gebruiker wil ik het mandaat van een systeem valideren]]<br>
-Iedereen met een PKI-overheidscertificaat kan de endpoints ophalen van een onderwijsinstelling/adminstratiekenmerk voor een bepaalde dienstversie.<br>
+Verifiëren of de onderwijsinstelling een mandaat heeft afgegeven aan een systeem.<br>
-Het endpoint omvat informatie zoals het afleveradres(technische url) van de gekoppelde leverancier, ingangsdatum, einddatum etc.. <br>
-[[OSR:2019/toevoegen_wijzigen_endpoints|Toevoegen/wijzigen endpoints]]<br>
+[[OSR:API/V2/Opvragen_endpoints|4. Als API-gebruiker wil ik een endpoint opvragen]]<br>
-De leverancier is gemandateerd voor de dienst door de onderwijsinstelling. Met een token kan een endpoint worden aangemaakt, danwel gewijzigd.<br>
+Ophalen van endpoints van een onderwijsinstelling of routeringskenmerk voor een bepaalde dienstversie.<br>
-<br><br>
+[[OSR:API/V2/toevoegen_en_wijzigen_van_endpoints|5. Als API-gebruiker wil ik een endpoint toevoegen of wijzigen]]<br>
-De volgende services zijn nog niet beschikbaar, maar de verwachting is dat deze binnenkort worden toegevoegd:
+Endpoints aanmaken en wijzigen door een gemandateerd systeem.<br>
-<br>
-Opvragen diensten
-<br>
-Opvragen dienstversies
-<br>
-Opvragen leveranciers
-<br>
+{{Info|
+Momenteel werken we aan een nieuwe versie van de API om ook mandateren op bestuursniveau mogelijk te maken.<br>
+Bekijk [[OSR:API/V2/API_V2_naar_V3_wijzigingen|hier]] de veranderingen ten opzichte van de huidige versie.
+}}
-{{Info|Voor inhoudelijke vragen kunt u bij voorkeur contact opnemen via de OSO techlijst ([mailto:info@tech.oso-od.nl info@tech.oso-od.nl]] lidmaatschap vereist) of via [mailto:servicedesk@oso-od.nl servicedesk@oso-od.nl]}}
+| style="padding-left:4em" |
+=== OSR kwalificatie ===
+[[:File:Kwalificatie test plan OSR.pdf|Kwalificatie test plan OSR 2.2]]
-{| cellspacing="10" cellpadding="5" border="0" width="90%"
+=== Hotlinks ===
-|- valign="top"
+[https://osr.kennisnet.nl/api/v2/documentation API documentatie]<br/>
-| style="width:60%" |
+[[OSR:omgevingen|OSR Omgevingen]]<br/>
+[[OSR:dienst-versies|OSR Dienst versies]]
-=== OSO specificatie ===
-[[OSO:Releases/2018-01|Wijzigingen in OSO'18''']]<br>
+=== Security ===
+Kennisnet standaarden rondom<br>[https://developers.wiki.kennisnet.nl/index.php?title=Standaarden:Beveiligd_Gegevenstransport beveiligd gegevenstransport].
-[[OSO:2018/Algemene_Eisen|Algemene eisen]]<br>
+=== Ondersteuning ===
-[[OSO:2018/Inhoudelijke_Eisen|Inhoudelijke eisen]]<br>
-[[OSO:2018/Specifieke_Eisen|Functionele eisen]]<br>
-[[OSO:2018/beveiliging|Beveiligingseisen]]<br>
-<br>
-[[OSO:2018/PDF-viewer | PDF-viewer]]
-<br>
-[[OSO:2018/Architectuur|Architectuur]]<br>
-[[OSO:2018/FAQ|Veelgestelde vragen]]<br>
-| style="width:40%" |
-=== Hotlinks ===
-* [[OSO:2018/Omgevingen|Omgevingen + WSDL]]
-=== OSO'18 Test ===
-*[[OSO:2018/Testplanning_leveranciers|Testplanning]]
-*[[OSO:2018/Testplannen|Testplannen]]
-*[[OSO:2018/Leverancier/Testschool|Testschool]]
-=== Externe informatiebronnen ===
+[[OSR:Begrippenlijst|Begrippenlijst]]<br>
-* [https://www.edustandaard.nl/standaarden/afspraken/afspraak/oso-gegevensset/2017.1/ EduStandaard OSO (dossier standaard)]
+[[OSR:Veelgestelde_vragen|Veelgestelde vragen]]
-*[[KVS:Hoofdpagina|Kennisnet Validatie Service]]
-* [[OSO:2017/Woordenlijst|Woordenlijst]]
-=== Communicatie ===
+[[Category:OSR]]
-{{ComItem|Homepage|Overstap Service Onderwijs site|http://www.overstapserviceonderwijs.nl/}}
-{{ComItem|Rss|Atom Feed wijzigingen OSO wiki|{{Rsslink}}}}
-|}