Document toolboxDocument toolbox

Release notes - Publieke API

Deze pagina geeft per release weer welke wijzigingen doorgevoerd worden met impact op de publieke API.

Bij elke release vind je 2 data terug: wanneer deze versie beschikbaar komt op de staging omgeving en wanneer deze beschikbaar staat op de productie omgeving.

  • Voor wijzigingen die geen impact hebben op bestaande implementaties (non-breaking changes zoals extra functionaliteiten, extra velden, …) wordt de release op productie 1 week na de release op staging uitgevoerd.

  • Voor wijzigingen met impact op bestaande implementaties (breaking changes) worden de release data zowel op staging als op productie ruim op voorhand aangekondigd.

De versie nummering wordt gelijk gehouden voor alle ontwikkelingen van het verenigingsregister. Soms gebeurt het dus dat een nieuwe versie in productie gezet wordt die geen impact heeft op de publieke API. In dat geval gaan we die versie gewoon vermelden, al was het maar om de versie nummers te kunnen controleren.

Het huidige versie nummer van de publieke API vind je terug in de API documentatie. Helemaal onderaan wordt het versie nummer dat nu op die omgeving staat weer gegeven.

 

Status van de diensten: zie https://www.vlaanderen.be/digitaal-vlaanderen/status/status-overzicht?product=Verenigingsregister

Versie 8.92.1 Adresmatch op ingevoerde adressen + statuspagina

Datum staging: Apr 30, 2024

Datum productie: May 15, 2024 (verwacht - uitgesteld)

Adresmatch op ingevoerde adressen

Alle ingevoerde adressen worden nagekeken of ze al dan niet overeenkomen met een bestaand adres uit het adressenregister. Wanneer een match gevonden wordt, wordt de juiste spelling van het adres overgenomen. Het adres krijgt dan ook een adres ID toegewezen (zie locaties.adresId.bronwaarde)

Statuspagina

Op https://www.vlaanderen.be/digitaal-vlaanderen/status/status-overzicht?product=Verenigingsregister vind je de status van de verschillende API’s op de 2 omgevingen terug. Je kan je ook abonneren op meldingen zodat je hiermee automatisch op de hoogte gebracht wordt van nieuwe releases en/of zware incidenten.

Versie 8.85.8 Bugfix voor de synchronisatie met KBO

Datum staging: Apr 3, 2024

Datum Productie: Apr 10, 2024

Bugfix voor de synchronisatie met KBO

Na de release op staging van de vorige versie, is gebleken dat er nog problemen waren met de synchronisatie met KBO. Deze bugs zijn in deze versie aangepakt, zodat we nu toch van start kunnen gaan met de KBO synchronisatie.

Versie 8.85.3 Synchronisatie met KBO, bugfixes voor JSON-LD formaat

Datum Staging: Mar 18, 2024

Datum productie: Mar 25, 2024(geannuleerd)

Synchronisatie met KBO

De gegevens van de verenigingen met rechtspersoonlijkheid worden bij registratie overgenomen uit KBO. Vanaf nu gaan we ook dagelijks de wijzigingen in KBO synchroniseren naar het verenigingsregister. Zowel de naam, korte naam, startdatum, maatschappelijke zetel als de contactgegevens worden daarbij gecontroleerd. Ook wanneer een KBO vereniging stopt in KBO (status in KBO is niet langer Actief of in oprichting), wordt de vereniging gestopt in het verenigingsregister.

Bugfixes JSON-LD

2 kleine wijzigingen aan het JSON-LD output formaat:

  • De context bevatte nog een komma op het einde wat een probleem veroorzaakte bij het converteren naar triples

  • Bij het veld hoofdactiviteit.code was de prefix act: vergeten

Versie 8.78.0 Verbeteringen aan het sorteren in publieke zoek, output in JSON-LD formaat

Datum Staging: Mar 4, 2024

Datum productie: Mar 11, 2024

Verbeteringen publiek zoek sorteren

Wanneer de resultaten van de publieke zoek gesorteerd worden op een tekstveld, dan worden ook hier enkele verschillen in schrijfwijze genegeerd om een intuitievere sortering te bekomen.

Bij het sorteren op tekstvelden, negeren we enkele verschillen in schrijfwijze:

  • hoofdletter ongevoelig ( A = a, B = b, …)

  • accent ongevoelig (é = è = ê = ë = e, à = â = ä = a, …)

  • puntjes worden weggewerkt (a.b.c = abc)

  • leading spaces (zodat “ AAA” voor “ZZZ” komt)

Output in JSON-LD formaat

Zowel de publieke zoek als de publieke detail endpoints zijn nu in JSON-LD formaat. Om dit te realiseren zijn enkele velden toegevoegd en is ook het context bestand opgevuld. Samen zorgen deze er voor dat de gehele output correct vertaald kan worden naar triples.

Versie 8.53.3 - geen impact op publieke API

Datum productie: Feb 5, 2024

Versie 8.52.0 - verbeteren publieke zoek resultaten, toevoegen korte beschrijving aan publieke zoek

Datum productie: Jan 26, 2024

verbeteren publieke zoek resultaten

Bij het zoeken op tekstvelden, negeren we enkele verschillen in schrijfwijze:

  • hoofdletter ongevoelig ( A = a, B = b, …)

  • accent ongevoelig (é = è = ê = ë = e, à = â = ä = a, …)

  • puntjes worden weggewerkt (a.b.c = abc)

  • leestekens worden genegeerd

toevoegen korte beschrijving aan publieke zoek

In het zoekresultaat werd nu ook de korte beschrijving toegevoegd. Dit veld kan eveneens gebruikt worden als zoekcriterium.

Voorbeeld: Onderstaande URL zoekt naar alle verenigingen die het woord tennis in hun korte beschrijving hebben staan. Het 2e voorbeeld zoekt naar alle verenigingen die het woord tennis in een van de zoekvelden hebben staan, dus niet alleen in de korte beschrijving, maar dit kan ook terug te vinden zijn in de naam, de korte naam, het adres…

GET <publiekURL>/v1/verenigingen/zoeken?q=korteBeschrijving:*tennis* GET <publiekURL>/v1/verenigingen/zoeken?q=*tennis*