Vraag:

Afgelopen week mocht ik voor een opdrachtgever een Realworks API koppeling met WordPress upgraden. Realworks biedt een CRM informatiesysteem aan voor makelaars. Deze API koppeling was nodig om koophuizen op de website van de makelaar in te laden.
Realworks heeft begin 2026 aangekondigd dat op 1 mei 2026 versie 1 van de API komt te vervallen en dat je moet upgraden naar versie 2. Ook de versie 1 endpoints moeten bijgewerkt worden naar versie 3. Realworks wil hiermee alles toekomstbestendig maken.
Voor de uitwisseling van gegevens / content via de Realworks API koppeling wordt gebruik gemaakt van een JSON-structuur of JSON-resultaat. Maar hoe kom ik er eenvoudig achter wat de verschillen zijn tussen beiden resultaten van de v1 en v3 endpoints?
Antwoord:
De eerste stap is om van beiden endpoints een JSON-structuur of resultaat te hebben. Ik zelf heb gebruik gemaakt van Postman om beiden endpoints aan te spreken. Maar je kan ook gebruik maken van cUrl. Het is maar wat je zelf fijn vindt.
Natuurlijk kan je de beiden structuren vergelijken in Notepad++ op Windows of Sublime op macOS. Maar ik heb ervoor gekozen om beiden resultaten te vergelijken via de website www.jsondiff.com. Die vergelijkt beiden JSON-resultaten in een paar seconden en laat zien waar de verschillen zitten.
Gelukkig waren er maar een viertal wijzigingen die ik moest doorvoeren aan de ontvangende API kant in de WordPress website. Inmiddels werkt de Realworks API koppeling op versie 2 met de endpoints op versie 3.
Getest met:
Twee JSON-structuren van twee verschillende API versies
