Voor 1 januari 2027: overstappen naar Bronhouderportaal API versie 3

Versie 3 van de Bronhouderportaal API is een veiligere en modernere wijze van toegang bij het gebruik van de API van het Bronhouderportaal. Je hebt een half jaar de tijd om over te stappen naar deze nieuwe versie. Dat betekent dat je vanaf 1 januari 2027 alleen nog maar versie 3 kunt gebruiken om geautomatiseerd aan te leveren of gegevens te valideren. Het komende half jaar is dus een overgangsperiode.

Waarom noodzakelijk

Bij versie 2 van de Bronhouderportaal API wordt de gebruiker geïdentificeerd met basic authentication: gebruikersnaam/wachtwoord. Bij de nieuwe versie (versie 3) wordt gebruikgemaakt van OAuth2.0 als authenticatiemechanisme. Dit gaat via OIDC (OpenID Connect). Deze methode is veiliger en past beter bij moderne API-beveiliging en cloud oplossingen zoals het Bronhouderportaal. Je kunt het vergelijken met een moderner slot op deur om toegang beter te kunnen regelen. Veiligheid vinden we erg belangrijk en deze aanpassing is ook wettelijk vereist.

Overstappen naar versie 3: nieuwe url en aanlevertoken

Er is een kleine aanpassing nodig om over te kunnen stappen naar versie 3. Hiervoor staat een handleiding voor je klaar: Bronhouderportaal BRO API v3. Ook staat daarin hoe je een versie 3 aanlevertoken aanmaakt. Wil je versie 3 testen in de demo-omgeving? Dat kan. Gebruik dan deze handleiding: Bronhouderportaal BRO API v3 demo.

Vragen of hulp nodig?

Heb je vragen over het overstappen op versie 3 de Bronhouderportaal API? Neem contact op met de collega’s van de BRO Servicedesk. Zij kunnen je verder helpen, al dan niet in samenwerking moet onze technisch experts.

Let op: nog even uitstellen kan, maar uiterlijk 1 januari 2027 moet je overgestapt zijn.