PDOK gaat de URL-structuur wijzigen van een deel van haar services.
Dat doen we met zo min mogelijk impact voor de gebruikers. Huidige URL’s blijven bruikbaar.
Van eigenaar naar aanbieder
Deze wijziging wordt doorgevoerd omdat tot nu toe de vorm van de PDOK-URL’s van elkaar verschilt.
Ook stellen we URL’s met een ‘oude’ data-eigenaar beschikbaar die nu niet meer kloppen. Bijvoorbeeld datasets die eerder van BZK waren en nu van VRO zijn.
Om URL’s stabieler te maken gaan we ‘data-eigenaar’ nu wijzigen in ‘data-aanbieder’.
Toelichtende opmerkingen:
- URL’s zoals die nu bestaan blijven werken (zolang de service versie niet geüpdatet wordt)
- We doen dit niet met redirects, dus de services blijven echt benaderbaar op de URL die je nu gewend bent
- De door de service gecommuniceerde URL’s van de service zelf gaan wijzigen (bijvoorbeeld in de Capabilities van OGC webservices en de URL’s in de metadata waar de service naar verwijst. Ook wanneer je de service op de oude URL bezoekt)
- De oude URL is dus niet meer terug te vinden bij PDOK
- Een deel van onze URL’s gaat niet wijzigen op domein of servicetype, maar wel op dataset-eigenaar / functionele (dataset)naam zoals hier aangegeven: {domein}/{dataset-eigenaar}/{functionele (dataset)naam}/{service type}/{versie}
- Bij een versiewijziging in de API (bij een ‘breaking change’) is het wèl noodzakelijk om een overstap te maken naar de nieuwe URL met de nieuwe versie. Voor een dergelijke wijziging houdt PDOK altijd 6 maanden overstaptijd aan; bijbehorende datum wordt tijdig en transparant gecommuniceerd. Deze datum is het uiterlijke moment dat je als gebruiker een change doorgevoerd dient te hebben
- Indien een service niet wijzigt (geen nieuwe versie) blijft deze dus steeds benaderbaar met de huidige URL
Eventuele vragen beantwoordt PDOK graag!
Uitleg of meer lezen?
- Voor uitleg van afkortingen en begrippen die gaan over webservices en OGC API’s, klik hier
- Meer info over organisatie en gebruik van PDOK, zie promo-film, factsheet, kracht van het dataportaal of rapportages
- Meer info over het ontsluiten van open data van de overheid inclusief handreiking