Un webhook avvisa il Suo sistema con un messaggio firmato quando una planimetria viene creata o salvata, o un export o un rapporto di misurazione è pronto.
Per questo serve Pro.
Webhook: passo dopo passo
1. Aprire Impostazioni, API
I webhook si trovano sotto le chiavi API. Deve essere proprietario o amministratore di uno spazio di lavoro con Pro o Team.
2. Aggiungere un webhook
Digiti un indirizzo https, scelga gli eventi e clicchi su Aggiungi webhook. Copi il segreto di firma: lo mostriamo una sola volta.
3. Verificare la firma
Ogni messaggio ha l’intestazione Squaremetry-Signature con t (l’ora) e v1, l’HMAC-SHA256 di "t.body" con il Suo segreto. Rifiuti un messaggio se non corrisponde o se t ha più di 5 minuti. La pagina per sviluppatori ha un esempio.
4. Saltare i doppioni
Squaremetry-Event-Id resta uguale a ogni tentativo e con Invia di nuovo. Se ha già visto l’id, risponda 200 e non faccia nulla.
5. Quando il Suo sistema non risponde
Tutto ciò che non è una risposta 2xx entro 10 secondi viene riprovato dopo 1, 5 e 30 minuti, poi dopo 2, 6, 12 e 24 ore. Dopo 8 tentativi rinunciamo; dopo 20 rinunce di fila il webhook si disattiva da solo.
6. Prova, disattivazione, nuovo segreto
Invia messaggio di prova invia un ping. Ultimi invii elenca ciò che è stato inviato, con Invia di nuovo. Nuovo segreto sostituisce subito il segreto. Quando Pro o Team finisce, i webhook sono In pausa: non viene inviato nulla, e può solo disattivarli o rimuoverli finché il piano non torna.
Messaggi che può vedere
- Usi un indirizzo che inizia con https://.
- Questo indirizzo è in una rete privata. Usi un indirizzo pubblico.
- Disattivato dopo 20 invii falliti di fila. Corregga l’indirizzo e poi lo riattivi.