Invii eventi al suo sistema con webhooks

Un webhook consente a IDup di chiamare un Suo indirizzo web nel momento in cui accade qualcosa, ad esempio quando una fattura viene pagata. Ogni consegna è firmata e ripetuta se il Suo sistema non risponde.

Aggiungere un endpoint

1. Apri il Webhooks scheda e prema Aggiungere endpoint.
2. Inserisca un Nome e il URL. Deve essere pubblicamente raggiungibile. Gli indirizzi all'interno di una rete privata sono rifiutati per motivi di sicurezza.
3. Selezioni il Eventi desidera.
4. Opzionale: scelga un Chiave API. L'endpoint riceve solo eventi che questa chiave può leggere.
5. Stampa Salva. IDup mostra Il Suo segreto di firma una volta. Conservarlo in sicurezza.

Eventi

• Fattura creata, Fattura pagata, Pagamento ricevuto
• Nuovo cliente, Nuovo contatto, Nuovo lead, Nuovo ticket
• Offerta accettata — un preventivo accettato da un cliente

Ogni consegna porta tre intestazioni: il nome dell'evento, un numero di consegna e la firma. Un nuovo tentativo mantiene lo stesso numero di consegna, così il suo sistema può riconoscere i duplicati.

Verifica la firma

Il Suo sistema dovrebbe calcolare un HMAC-SHA256 sul tempo e sul corpo grezzo con il Suo segreto, confrontarlo con la firma e rifiutare un tempo più vecchio di 5 minuti. Premere Verifica firma ed esempi per il codice preconfezionato.

Test, pausa e rinnovo

• Invii un test invia un evento di prova e mostra il codice HTTP e il tempo impiegato.
• Pausa ferma le consegne; Attivare li avvia nuovamente.
• Segreto del rotolo crea un nuovo segreto. Quello vecchio smette di funzionare immediatamente.
• Elimina rimuove l'endpoint. Il suo registro è conservato.

Ritenti e il registro

Il Suo indirizzo deve rispondere con un codice 2xx entro 5 secondi. I reindirizzamenti non vengono seguiti. Se fallisce, IDup riprova dopo 1 minuto, 5 minuti, 30 minuti, 2 ore e 12 ore. Dopo il sesto tentativo, la consegna viene contrassegnata Rinunciato.

Il registro mostra ogni tentativo con evento, endpoint, tentativo, codice HTTP, durata e l'inizio della risposta. Lo stato è In attesa, Consegnato, Non riuscito o Rinunciato. Usi Reinvia per inviare nuovamente una consegna.