Externe API

Met de externe API koppel je je eigen software aan Renovatieplanner: je planningspakket, je ERP, een dashboard of een middleware-laag. Je haalt projecten, woningen, formulieren, ingevulde formulieren (als gegevens of als PDF) en taken op, werkt de status van een taak bij, en krijgt direct bericht wanneer een formulier in het veld is afgerond.

• •Projecten en woningen ophalen, inclusief wijzigingen sinds een bepaald moment, zodat je eigen systeem altijd gelijk loopt.
• •Formulieren en inzendingen lezen: elk antwoord per vraag, met foto's, of de complete inzending als PDF. Met een eigen kenmerk per vraag zoek je antwoorden op in al je projecten.
• •Taken en opleverpunten ophalen per project, woning, type of status, en vanuit je eigen systeem de status zetten of een opmerking plaatsen.
• •Webhooks: zodra een formulier is afgerond stuurt Renovatieplanner een ondertekend bericht naar jouw URL, met een link naar de gegevens en de PDF. Lukt bezorgen even niet, dan proberen we het automatisch opnieuw.

• •Per koppeling een eigen API-sleutel met precies de rechten die ze nodig heeft, bijvoorbeeld alleen lezen of alleen taken bijwerken. Een sleutel trek je met één klik in zonder de andere te raken.
• •Bewonersgegevens komen alleen mee als je dat recht expliciet aanzet; elk gebruik wordt vastgelegd.
• •Webhook-berichten zijn voorzien van een handtekening, zodat je zeker weet dat ze van Renovatieplanner komen.
• •Elke aanroep en elke wijziging staat in het audit-spoor van je organisatie.

De externe API is een module van Renovatieplanner die per organisatie wordt aangezet. Neem contact op met je contactpersoon of de helpdesk om de module af te sluiten. Daarna maakt een beheerder zelf sleutels en webhooks aan onder Bedrijfsinstellingen → Koppelingen.

Wil je liever een AI-assistent zoals Claude aan Renovatieplanner koppelen in plaats van eigen software? Kijk dan bij de AI-koppeling (MCP).

De API is een gewone REST API met JSON, een API-sleutel in de Authorization-header en een OpenAPI-specificatie die je in je eigen tooling kunt laden. De basis-URL is:

https://connect.renovatieplanner.nl/v1

Een eerste aanroep, die teruggeeft voor welke organisatie en rechten je sleutel geldt:

curl https://connect.renovatieplanner.nl/v1/me \
  -H "Authorization: Bearer rpa_jouw_sleutel"

De interactieve documentatie met alle endpoints, velden en voorbeelden staat op de documentatiepagina van de API; daar vind je ook hoe je de handtekening van een webhook controleert in Node.js, PHP en C#.

Oude koppeling via /externalApi

Gebruik je nog de oude koppeling via /externalApi? Die blijft voorlopig werken, maar nieuwe functies komen alleen in de nieuwe API. In de documentatie staat een tabel met de oude en de nieuwe aanroepen naast elkaar.

Documentatie: https://connect.renovatieplanner.nl/v1/docs