Quelles sont les données que je reçois d'un événement de webhook?

Actuellement, 2 événements sont mis à disposition pour lesquels des webhooks peuvent être enregistrés.

Nouvelle exportation de projet disponible

Un membre de mon organisation a lancé un export de projet qui peut maintenant être téléchargé.

{
    "projectExportId": "56fd1bea2edf4851862dcfc034c87b30", // Id des Projektexports. Guid.
    "projectId": "aea8c39fd41742fd89f779834b67c5a8", // Id des Projektes. Guid.
    "createdDate": "2025-05-13T08:43:15.313Z", // UTC Datum und Zeit, zu der der Projektexport erstellt wurde. ISO 8601. String.
    "exportCollaboratorId": "1d53734ce38144fe8c6db599b650d0a0", // Id des Projektteilnehmenden, der den Projektexport erstellt hat. Guid.
    "exportUserId": "72ec285339284845adb55d82bec53a6a", // Id des Users, der den Projektexport erstellt hat. Guid.
    "userLanguage": "de-ch", // Sprache, die der User für sich eingestellt hat. ISO 639-2. String.
    "downloadUrl": "https://export.smino.ch/exports/56fd1bea2edf4851862dcfc034c87b30/download-multiple/docEntries,Journale+addresses,Kontakte+inspections,Abnahmen/Projektexport_Renovation_2025-05-13", // Link, über den ein .zip des kompletten Exports heruntergeladen werden kann. Der Name des .zip ist in die Sprache des Users übersetzt. String.
    "expectedArtefactsCount": 5, // Wieviele Artefakte im kompletten .zip Export erwarted werden. Int.
    "completedArtefactsCount": 2, // Wieviele Artefakte wirklich im kompletten .zip sind. Int.
    "domains":
        [
            {
                "domain": "Kontakte", // Name des exportierten Bereichs. "Kontakte", "Aufgaben", "Protokolle", "Konversationen", "Dokumente", "Pläne", "Journale", "Abnahmen". String.
                "status": "Completed", // Status des exportierten Bereichs. "Completed" oder "Failed". String.             
                "expectedArtefactsCount": 3, // Wieviele Artefakte im .zip Export dieses Bereiches erwarted werden. Int.             
                "completedArtefactsCount": 2, // Wieviele Artefakte wirklich im .zip sind. Int.
                "downloadUrl": "https://export.smino.ch/exports/56fd1bea2edf4851862dcfc034c87b30/download/addresses/Kontakte_Renovation_2025-05-13", // Link, über den das .zip heruntergeladen werden kann. Ist null, wenn der Stauts "Failed" ist. Der Name des .zip ist in die Sprache des Users übersetzt. String.
                "sizeInBytes": 60593 // Grösse des .zip. Long.
            }
        ],
}

Statut d'une tâche modifié

Le statut d'une tâche créée par un membre de mon organisation ou attribuée à un membre de mon organisation a changé.

{
    "projectId": "aea8c39fd41742fd89f779834b67c5a8", // Id du projet. Guid.
    "issueId": "f242a1a7b92448f5b78c0aefa511491e", // Id de la tâche. Guid. 
    "parentId": "50bca98e13984541957dcd5cd32291be", // Id de la surtâche de la tâche, si elle en a une. Sinon, il est nul. Guid.
    "title": "Riss in der Wand", // Titre de la tâche. String. 
    "type": "Aufgabe", // Type de tâche. "Aufgabe", "Mangel" ou un type défini par l'utilisateur. String.
    "oldStatus": "inProgress", // Le statut précédent de la tâche. "unknown", "open", "inProgress", "done", "declined", "draft", "withoutMeasure". String. 
    "newStatus": "done", // Le statut actuel de la tâche. "unknown", "open", "inProgress", "done", "declined", "draft", "withoutMeasure". String. 
    "updaterCollaborator":
        {
            "id": "31804f33f6a04c53a61ac95a981cb474", //  Id du participant au projet qui a changé le statut de la tâche. String.         
            "userId": "467b2de7f5cc4102920224c2f8ce2a21" // Id de l'utilisateur qui a modifié le statut de la tâche. String. 
        }
    }

Tester les webhooks

Les webhooks peuvent aussi être facilement testés via cette page : https://webhook.site

Pour cela, créer un webhook avec l'URL générée par cette page. Déclencher ensuite l'événement correspondant et attendre une réponse sur la page.

Mis à jour le : 01/07/2025