Webhooks
Webhooks sind eine Möglichkeit, um über bestimmte Ereignisse in signoSign/Universal informiert zu werden. Dazu wird eine URL angegeben, die von signoSign/Universal bei einem Ereignis aufgerufen wird. Der Inhalt jedes Webhook-Aufrufs ist ein JSON-Objekt, das den Kontext abbildet, in dem das Ereignis aufgetreten ist und je nach Kontext variiert die Menge an Informationen, die übermittelt werden. So werden beim Speichern eines Dokuments durch den Benutzer selbst z.B. keine SharingCase-Informationen übermittelt. Findet das Speichern aber als Teil eines Workflows statt, werden die Workflow-Informationen übermittelt.
In dem Bereich webhooks der Einstellungen können Sie für jedes mögliche Ereignis eine separate URL definieren.
Inhalt von Webhooks
JSON
{
"Event": {
"TimeStamp": Date as string(yyyy-MM-dd'T'HH:mm:ss.SSSXXX),
"EventType": string,
"Software": {
"Name": "SignoSign/Universal",
"Version": string
},
"User": {
"UserName": string
},
"EventData": {
"Document": {
"DocumentName": string,
"DocumentId": number,
"SignatureFields": number,
"MandatoryFields": number,
"SignedSignatureFields": number,
"SignedMandatoryFields": number,
"FormFields": [
{
"Name": string,
"Value": string,
"Mandatory": boolean
},
]
},
"SharingCase": {
"SharingCaseId": number,
"AccessId": string
},
"Workflow": {
"ProcessId": string
}
}
}
}