Met de API vraag je zelf gegevens op. Wil je liever dat Climatools jou laat weten wanneer er iets verandert? Dat kan met webhooks. In dit artikel lees je hoe je die instelt.
Hoe stel ik een webhook in?
Naast de API kun je real-time meldingen instellen.
1. Ga naar Instellingen > Webhooks.
2. Geef een webhook-URL op.
3. Kies de gebeurtenissen waarover je geïnformeerd wilt worden.
Je kunt bijvoorbeeld kiezen voor company.created, company.updated en company.deleted. Er zijn vergelijkbare gebeurtenissen voor relaties, adressen en installaties.
Wat gebeurt er als er iets verandert?
Zodra zo’n gebeurtenis plaatsvindt, sturen we een POST-verzoek met de relevante gegevens naar jouw webhook-URL.
Hoe controleer ik of een verzoek echt van Climatools komt?
Genereer ook een webhook-geheim. Hiermee wordt elke payload ondertekend met HMAC-SHA256, zodat je kunt controleren dat een binnenkomend verzoek echt van Climatools komt.