Een webhook stuurt een ondertekend bericht naar uw eigen adres als een plan gemaakt of bewaard is, een export klaar is of een meetrapport klaar is.
Hiervoor heeft u Pro nodig.
Webhooks: uw eigen systeem laten weten dat er iets veranderde: stap voor stap
1. Open Instellingen, API
Webhooks staan onder de API-sleutels. U moet eigenaar of beheerder zijn van een werkruimte met Pro of Team.
2. Webhook toevoegen
Typ een https-adres, kies de gebeurtenissen en klik op Webhook toevoegen. Kopieer het geheim om te ondertekenen: wij tonen het maar één keer.
3. Controleer de handtekening
Elk bericht heeft de kop Squaremetry-Signature met t (de tijd) en v1, de HMAC-SHA256 van "t.body" met uw geheim. Weiger een bericht als die niet klopt of als t ouder is dan 5 minuten. De ontwikkelaarspagina heeft een voorbeeld.
4. Dubbele berichten overslaan
Squaremetry-Event-Id blijft hetzelfde bij elke poging en bij Opnieuw versturen. Kent u de id al, antwoord dan 200 en doe verder niets.
5. Als uw systeem even weg is
Alles behalve een 2xx-antwoord binnen 10 seconden proberen wij opnieuw na 1, 5 en 30 minuten, daarna na 2, 6, 12 en 24 uur. Na 8 pogingen geven wij het op; na 20 opgegeven berichten achter elkaar zet de webhook zichzelf uit.
6. Testen, uitzetten, nieuw geheim
Testbericht sturen stuurt een ping. Laatste bezorgingen toont wat er verstuurd is, met Opnieuw versturen. Nieuw geheim vervangt het geheim meteen. Stopt Pro of Team, dan staan de webhooks op Gepauzeerd: er gaat niets de deur uit, en u kunt ze alleen uitzetten of verwijderen tot het plan terug is.
Meldingen die u kunt zien
- Gebruik een adres dat begint met https://.
- Dit adres ligt in een eigen netwerk. Gebruik een openbaar adres.
- Uitgezet na 20 mislukte bezorgingen achter elkaar. Herstel het adres en zet de webhook weer aan.