Callback webhook

Utilizzo

L'endpoint /request/create consente agli iniziatori di definire un URL webhook per ogni richiesta, da utilizzare per un callback al completamento della firma.

Gli iniziatori sono liberi di includere parametri dinamici nell'URL di callback per identificare in modo univoco una particolare richiesta. L'URL passato nel parametro webhook-url deve essere codificato in formato URL.

Richiesta

Il callback viene inviato come richiesta POST con corpo vuoto.

Autenticazione

Facoltativamente e su richiesta, Certifaction può impostare un valore segreto a livello di account da utilizzare nelle chiamate webhook. In questo modo l'iniziatore può assicurarsi che il callback sia stato effettivamente emesso da Certifaction.

Il segreto verrà allegato alle chiamate nel seguente header:

• authorization: Bearer <secret>