Enviï esdeveniments al seu propi sistema amb webhooks

Un webhook permet que IDup truqui a una adreça web seva en el moment que passa alguna cosa, per exemple quan es paga una factura. Cada lliurament es signa i es repeteix si el seu sistema no respon.

Afegir un punt final

1. Obri el Webhooks pestanya i premeu Afegir punt final.
2. Introduïu un Nom i el URL. Ha de ser públicament accessible. Les adreces dins d'una xarxa privada es rebutgen per raons de seguretat.
3. Marqui el Esdeveniments vostè vol.
4. Opcional: triï un Clau d'API. El punt final només rep esdeveniments que aquesta clau pot llegir.
5. Premsa Desar. IDup mostra El seu secret de signatura una vegada. Emmagatzemi-la de manera segura.

Esdeveniments

• Factura creada, Factura pagada, Pagament rebut
• Nou client, Nou contacte, Nou client potencial, Nou tiquet
• Oferta acceptada — un pressupost que un client ha acceptat

Cada lliurament porta tres encapçalaments: el nom de l'esdeveniment, un número de lliurament i la signatura. Un reintent manté el mateix número de lliurament, de manera que el seu sistema pot reconèixer duplicats.

Comprovar la signatura

El seu sistema hauria de calcular un HMAC-SHA256 sobre el temps i el cos cru amb el seu secret, comparar-lo amb la signatura i rebutjar un temps més antic de 5 minuts. Premi Verificar signatura i exemples per a codi predefinit.

Provar, pausar i renovar

• Enviï prova envia un esdeveniment de prova i mostra el codi HTTP i el temps que ha trigat.
• Pausa atura les entregues; Activar els torna a iniciar.
• Secret de rotlle crea un nou secret. L'antic deixa de funcionar immediatament.
• Elimini elimina el punt final. El seu registre es manté.

Reintents i el registre

La seva adreça ha de respondre amb un codi 2xx en 5 segons. No es segueixen redireccions. Si falla, IDup ho intenta de nou després d'1 minut, 5 minuts, 30 minuts, 2 hores i 12 hores. Després del sisè intent, el lliurament es marca Rendit.

El registre mostra cada intent amb esdeveniment, punt final, intent, codi HTTP, durada i l'inici de la resposta. L'estat és Esperant, Lliurat, Error o Rendit. Utilitzi Reenviar per enviar un lliurament de nou.