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 de l'exportation du projet. Guid.
    "projectId": "aea8c39fd41742fd89f779834b67c5a8", // Id du projet. Guid.
    "createdDate": "2025-05-13T08:43:15.313Z", // UTC Date et heure auxquelles l'exportation de projet a été créée. ISO 8601. String.
    "exportCollaboratorId": "1d53734ce38144fe8c6db599b650d0a0", //  Id du participant au projet qui a créé l'exportation de projet. Guid.
    "exportUserId": "72ec285339284845adb55d82bec53a6a", // Id de l'utilisateur qui a créé l'exportation de projet. Guid.
    "userLanguage": "de-ch", // Langue que l'utilisateur a choisie pour lui-même. ISO 639-2. String.
    "domains":
        [
            {
                "domain": "Kontakte", // Nom du domaine exporté. “Kontakte“, “Aufgaben“, “Protokolle”, “Konversationen”, “Dokumente”, “Pläne”, “Journale”, “Abnahmen”. String.
		"status": "Completed", // Statut de la zone exportée. « Completed » ou « Failed ». String.             
		"expectedArtefactsCount": 3, // Combien d'artefacts sont attendus dans l'exportation .zip de ce domaine. Int.             
		"completedArtefactsCount": 2, // Combien d'artefacts se trouvent réellement dans le .zip. Int.
		"downloadUrl": "https://export.smino.ch/exports/56fd1bea2edf4851862dcfc034c87b30/download/addresses/Kontakte_Renovation_2025-05-13", // Lien par lequel le .zip peut être téléchargé. Est nul si le staut est "Failed". Le nom du .zip est traduit dans la langue de l'utilisateur. String.
		"sizeInBytes": 60593 // Taille du .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 : 14/05/2025