Guide d'action
Sache qui a partagé quoi, avec qui, quand
POST
/v1/events · document.sharedÉmets un event `document.shared` chaque fois qu'un user génère un lien de partage, invite un destinataire ou change la visibilité d'un document.
Quand l'émettre
Dans l'endpoint de partage, après création de la ligne et avant mise en queue de l'email d'invitation.
Payload d'exemple
await recalled.events.create({
action: "document.shared",
actor: { id: user.id, email: user.email },
organization: user.organizationId,
metadata: {
documentId: "value",
visibility: "value",
recipientCount: "value"
},
});Metadata à inclure
Garde les metadata plates et cohérentes dans ton service pour que recherche et exports CSV fonctionnent bien.
| Clé | Rôle |
|---|---|
documentId | ID interne du document |
visibility | private, org_wide, link, public |
recipientCount | Nombre de destinataires distincts |
expiresAt | Date d'expiration du lien, si existante |
Rétention recommandée
Garder au moins 12 mois, le partage est le vecteur le plus courant d'exposition accidentelle.