De ondernemersplein API werkt met Semantic Versioning (http://semver.org).
Endpoints en versienummer
In de Ondernemersplein API hebben alle endpoints een URL met een versienummer. De endpoints zonder versie nummer in de URL bevatten altijd de laatste versie.
Bijvoorbeeld
/api/articles/ geen versienummer in de url, bevat de laatste versie (v3)
/api/v3/articles
/api/v2/articles
Beschikbare endpoints
In de SwaggerUI-pagina van de API, kunt u zien welke endpoints beschikbaar zijn. Inclusief de versies die momenteel ondersteund worden. Op deze pagina kunt u de Queries op de API op een makkelijkere manier testen.
Versie ophogen alleen bij grote aanpassingen
Alleen bij grote aanpassingen wordt de nieuwe versie opgehoogd. Dan komen er ook nieuwe endpoints beschikbaar. Bij kleine versiewijzigingen blijft de huidige versie (bijvoorbeeld api/v1/articles) ongewijzigd. Dan is deze ook altijd backwards-compatible.
Momenteel zijn er binnen de Ondernemersplein API alleen minor changes doorgevoerd en zijn alle endpoints backwards-compatible.
Versie overzicht
Versienummer, Datum wijziging |
Wat is er gewijzigd in deze versie |
Versie 1.30, 05-02-2020 |
Performance verbeteringen |
Versie 1.29, 11-12-2019 |
Bugfix voor uitlevering van CBS Charts |
Versie 1.28, 20-11-2019 |
Verschillende bugfixes voor CBS Charts |
Versie 1.27, 18-09-2019 |
Bugfix |
Versie 1.26, 28-08-2019 |
Fix voor barchart |
Versie 1.25, 18-07-2019 |
Nieuw endpoint voor uitgelichte thema artikelen |
Versie 1.24, 27-06-2019 |
Toevoegen van CBS grafiektype staafdiagram |
Versie 1.23, 04-04-2019 |
Verbeteringen aan thema endpoint |
Versie 1.22, 14-03-2019 |
Nieuw Ondernemersplein logo toegevoegd |
Versie 1.21, 21-02-2019 |
Nieuw endpoint voor het uitleveren van thema's toegevoegd |
Versie 1.20, 08-01-2019 |
Nieuwe url voor Ondernemersplein |
Versie 1.19, 18-10-2018 |
Relatieve urls van afbeeldingen worden nu als absolute url uitgeleverd |
Versie 1.18, 27-09-2018 |
Update metadata van CBS-grafieken |
Versie 1.17, 16-08-2018 |
Url veld toegevoegd aan articles endpoint |
Versie 1.16, 26-07-2018 |
Url veld toegevoegd aan subsidies endpoint |
Versie 1.15, 14-06-2018 |
Leesbaarheid verbeterd voor CBS-tabellen op mobiel en desktop |
Versie 1.14, 24-05-2018 |
Filtering op regio/onderwerp toegevoegd op de keuzepagina ‘Evenementen iFrame’ |
Versie 1.13, 01-03-2018 |
Mogelijkheid toegevoegd om evenementen te embedden in iFrame |
Versie 1.12, 22-03-2018 |
Extra sorteringsmogelijkheden toegevoegd voor endpoint (sort by id, desc) |
Versie 1.11, 21-02-2018 |
Kleine aanpassingen |
Versie 1.10, 08-02-2018 |
Verlopen bijeenkomsten niet meer zichtbaar. Contenttype ‘Webinars’ toegevoegd |
Versie 1.9, 05-01-2018 |
Update Nest en Serilog packages, _parent query support. Kleine verbeteringen. |
Versie 1.8, 21-12-2017 |
Koppeling tussen artikelen en antwoordpagina’s beschikbaar via de ‘IsPartOf’ knoop |
Versie 1.7, 01-12-2017 |
Zoek en sorteer functie toegevoegd. Contactblokken voor antwoordpagina’s toegevoegd. |
Versie 1.6, 02-10-2017 |
CBS grafieken toegevoegd in uitlevering artikel content |
Versie 1.5, 25-09-2017 |
Volgeboekte evenementen worden niet meer getoond |
Versie 1.4, 01-08-2017 |
Swagger UI interface documentatie. Article type “wetswijziging-nl” toegevoegd |
Versie 1.3, 20-07-2017 |
‘Articles endpoints’ uitbreiding met content Antwoord voor Bedrijven (AvB) |
Versie 1.2, 26-05-2017 |
Kleine aanpassingen |
Versie 1.1, 21-04-2017 |
Kleine aanpassingen |
Versie 1.0, 23-03-2017 |
Initiële versie |