OSR:2019/Opvragen onderwijsinstelling

Men kan informatie over onderwijsinstellingen opvragen met behulp van deze operatie. De aanwezige data is afkomstig van DUO Open data / RIO.
Onderstaande request is het basisrequest om alle onderwijsinstellingen op te vragen.

GET Request
/api/v1/schools

Het is mogelijk om specifiek te zoeken, onderstaande geeft een voorbeeld weer van de verschillende parameters.
Let op, de parameters worden met een ‘AND’ operator gecombineerd.

GET Request
/api/v1/schools?name=Vakschool&oin=0000000700000EF00000&brin=00EF&oa_id=123A125

Request parameters

Parameters	Omschrijving	Verplicht/Optioneel
Name	Naam van de onderwijsinstelling.	Optioneel
oin	Oin van de onderwijsinstelling	Optioneel
brin	Brin van de onderwijsinstelling	Optioneel
oa_id	Onderwijs aanbieder id van de onderwijsinstelling. Dit komt uit RIO	Optioneel

De response kan uit 0, 1 of meerdere onderwijsinstellingen bestaan. Hieronder is een voorbeeld weergegeven van de response:    Response  [{     "name": "Hubertus Vakschool",     "oin": "0000000700000EF00000",     "brin": "00EF",     "oa_id": "123A125",     "_links":    {        "self": {"href": "/api/v1/schools/3"},        "board": {"href": "/api/v1/boards/3"}     }  }] 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.kennisnet.nl/schemas/Overstapservice/20180404">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:pingRequest/>
   </soapenv:Body>
</soapenv:Envelope>