OSR:API/V2/API V2 naar V3 wijzigingen

Wijzigingen van de OSR API V2 naar V3

Met de introductie van versie 3 van de OSR API zijn er verschillende wijzigingen doorgevoerd ten opzichte van versie 2.
Deze documentatie geeft een overzicht van de belangrijkste veranderingen, inclusief nieuwe functionaliteiten, verwijderde of aangepaste endpoints
en verbeteringen op het gebied van beveiliging en prestaties.

Deze pagina is bedoeld voor ontwikkelaars en technische beheerders die werken met de OSR API en hun implementaties willen upgraden naar de nieuwste versie.
Door de wijzigingen tijdig te begrijpen en door te voeren, zorg je ervoor dat je applicaties compatibel blijven en profiteren van de nieuwste optimalisaties.

Bekijk hieronder de gedetailleerde wijzigingen en aanbevelingen voor een soepele migratie.

Wijzigingen per API endpoint

URI	Wijzigingen API V3
GET /boards/{bgeCode}	URI-parameter "{id}" wordt omgezet naar "{bgeCode}" Responseveld "number" wordt "bgeCode"
POST /endpoints	Bij gebruik van het token van een mandaat, welke op bestuursniveau is aangemaakt geeft de API terug: HTTP 400: The given service version does not allow endpoint registrations
GET /endpoints	Bij gebruik van de versie naamruimte van een dienst, welke alleen mandaten op bestuursniveau toestaat geeft de API een HTTP 200 met lege lijst terug.
GET /endpoints/{uuid} PUT /endpoints/{uuid} DELETE /endpoints/{uuid}	* URI-parameter "{id}" wordt omgezet naar "{uuid}"
GET /endpoints/available-routing-id	Deze vervangt het API endpoint "GET available_routing_id". Bij gebruik van de versie naamruimte van een dienst, welke alleen mandaten op bestuursniveau toestaat geeft de API een HTTP 200 met lege lijst terug.
GET /mandates/services/{serviceCode}/schools/{schoolOin}/suppliers/{supplierOin}	Deze vervangt het API endpoint "GET /mandates" Dit API endpoint geeft alleen mandaten op schoolniveau terug in de response; De parameter "service_version_namespace" is verwijderd; De parameters "serviceCode", "schoolOin" en "supplierOin" zijn verplicht en verplaatst naar de URI.
GET /mandates/services/{serviceCode}/boards/{bgeCode}/suppliers/{supplierOin}	Dit is een nieuw API endpoint, welke alleen mandaten op bestuursniveau in de response teruggeeft; De parameter "boardBgeCode" wordt gebruikt om het schoolbestuur te identificeren; Responseveld _links.board { "href": "string" } bevat een link naar het bij het mandaat behorende schoolbestuur.
GET /mandates/{uuid}	URI-parameter "{id}" wordt omgezet naar "{uuid}"; Zowel mandaten op school- als bestuursniveau worden teruggeven; Responseveld _links.board { "href": "string" } bevat een link naar het bij het mandaat behorende schoolbestuur; Responseveld "_links.board" is altijd gevuld, zowel bij een mandaat op school- als bestuursniveau; Responseveld "_links.school" geeft uiteraard alleen een waarde bij een mandaat op schoolniveau, anders is deze null.
GET /schools	"oa_id" komt niet meer voor als parameter en in responses. Responseveld "brin" wordt omgezet naar "oieCode"
GET /schools/{oieCode}	URI-parameter "{id}" wordt omgezet naar "{oieCode}" "oa_id" komt niet meer voor als parameter en in responses. Responseveld "brin" wordt omgezet naar "oieCode"
GET /school-mandates	"school_oa_id" komt niet meer voor in responses.
GET /services/{uuid}	URI-parameter "{id}" wordt omgezet naar "{uuid}"
GET /service-versions/{uuid}	URI-parameter "{id}" wordt omgezet naar "{uuid}"
POST /service-versions/copy-endpoints-from-service-version	Als de parameters "serviceVersionNamespaceToCopyTo" óf "serviceVersionNamespaceToCopyFrom" betrekking hebben op een dienst welke alleen mandaten op bestuursniveau toestaat geeft de API terug: HTTP 400: The given service version(s) do not allow endpoint registrations

Algemene aandachtspunten

• Alle responsevelden worden in V3 teruggegeven in camelCase in plaats van snake_case in V2
• Het is aanvankelijk niet mogelijk om endpoints aan te maken voor mandaten op bestuursniveau