Aller au contenu principal

Delete notification

DELETE 
/company/notifications/:id

Supprime définitivement une notification du système. Cette action est irréversible et libère de l'espace dans la base de données.

Objectif​

Permettre aux entreprises de gérer leurs notifications en supprimant celles qu'elles n'ont pas besoin de conserver, permettant un nettoyage contrôlé de l'historique des alertes.

Cas d'utilisation​

  • Nettoyage de notifications anciennes : Supprimer des notifications historiques non pertinentes
  • Suppression individuelle : Lorsque l'utilisateur décide de supprimer une notification spécifique
  • Gestion du stockage : Réduire la taille de la base de données en supprimant des enregistrements inutiles
  • Suppression après action : Effacer les notifications après avoir complété l'action associée

Flux de suppression​

flowchart TD
    A[DELETE /{id}] --> B{ID fourni ?}
    B -->|Non| C[Vérifier le corps]
    B -->|Oui| D[Utiliser l'ID du chemin]
    C -->|Trouvé| E[Utiliser l'ID du corps]
    C -->|Non trouvé| F[Vérifier la requête]
    F -->|Trouvé| G[Utiliser l'ID de la requête]
    F -->|Non trouvé| H[400 Bad Request]
    D --> I{Utilisateur authentifié ?}
    E --> I
    G --> I
    I -->|Non| J[404 USER_NOT_FOUND]
    I -->|Oui| K{Entreprise existe ?}
    K -->|Non| L[401 CIA_NOT_FOUND]
    K -->|Oui| M{Notification existe ?}
    M -->|Non| N[404 NOTIFICATION_NOT_FOUND]
    M -->|Oui| O[Supprimer la notification]
    O --> P[Suppression permanente]
    P --> Q[Retourner la notification supprimée - 200]

Flexibilité des paramètres​

L'ID de la notification peut être envoyé de trois manières (par ordre de priorité) :

  1. Paramètre de chemin (recommandé) : `/company/not

Request​

Responses​

Notification supprimée avec succès.

La réponse contient la notification telle qu'elle existait avant d'être supprimée. Ces informations peuvent être utiles pour :

  • Confirmer ce qui a été supprimé
  • Mettre à jour l'interface utilisateur localement
  • Journalisation/audit