Notifications¶
Référence des événements déclenchant des notifications, des canaux disponibles et des préférences configurables via /settings/notifications.
Canaux de notification¶
gitrust envoie les notifications par deux canaux :
| Canal | Description | Configuration |
|---|---|---|
| SSE in-app | Notifications en temps réel dans l'interface web, via Server-Sent Events. Icône cloche en haut à droite. | Toujours actif quand tu es connecté |
| Emails envoyés à l'adresse de ton compte | Configurable par type d'événement dans /settings/notifications |
Matrice des événements × canaux¶
| Événement | SSE in-app | Déclencheur | |
|---|---|---|---|
| PR assignée (tu es reviewer) | ✓ | ✓ | Quelqu'un t'assigne comme reviewer d'une PR |
Issue mentionnée (tu es mentionné par @pseudo) |
✓ | ✓ | Ton pseudo apparaît dans une issue ou un commentaire |
| Review demandée | ✓ | ✓ | L'auteur d'une PR te demande explicitement une review |
| CI échouée (sur ton push) | ✓ | ✓ | Un pipeline CI lancé par ton push se termine en échec |
| CI réussie (sur ton push) | ✓ | — | Un pipeline CI lancé par ton push se termine en succès |
| Commentaire sur ta PR | ✓ | ✓ | Quelqu'un commente une PR dont tu es l'auteur |
| Commentaire sur ton issue | ✓ | ✓ | Quelqu'un commente une issue que tu as ouverte |
| PR fusionnée (tu es auteur) | ✓ | — | Ta PR est fusionnée |
| PR fermée (tu es auteur) | ✓ | — | Ta PR est fermée sans fusion |
| Issue fermée (tu es assigné) | ✓ | — | Une issue qui t'est assignée est fermée |
| Membre ajouté à une équipe | ✓ | ✓ | Tu es ajouté à une équipe |
| Accès dépôt accordé | ✓ | — | Un dépôt t'est rendu accessible (équipe ou direct) |
✓ = activé par défaut — — = non envoyé par défaut (peut être activé dans les préférences)
Configurer les préférences¶
Navigue vers Paramètres → Notifications (/settings/notifications).
La page affiche un tableau de cases à cocher pour chaque type d'événement × canal. Décoche les emails que tu ne veux pas recevoir et sauvegarde.
Stream SSE en temps réel¶
Les notifications SSE sont disponibles sur le endpoint :
Connexion en text/event-stream. Chaque notification est un événement JSON :
data: {"id": 42, "type": "pr_assigned", "repo": "owner/repo", "pr_num": 7, "created_at": "2026-04-17T10:15:00Z"}
Ce stream alimente l'icône cloche de l'interface. Il peut aussi être consommé par des outils externes (scripts, bots) via un PAT.
Marquer les notifications comme lues¶
- Une notification :
POST /notifications/{id}/read - Toutes les notifications :
POST /notifications/read-all - Via l'interface : clique sur une notification dans la liste
/notifications, ou utilise le bouton Tout marquer comme lu
Voir aussi¶
- Créer un Personal Access Token : accéder au stream SSE par script
- API REST v1 : les endpoints de notifications ne sont pas listés dans l'API v1 publique — le stream SSE est le seul canal programmatique exposé