Événements en Temps Réel
Legalesign peut envoyer des événements à votre application en temps réel — document signé, téléchargement terminé, envoi échoué, etc. Il existe deux mécanismes, que vous pouvez utiliser l’un ou l’autre, ou les deux.
Abonnements
Les abonnements GraphQL ouvrent une connexion WebSocket persistante vers le point de terminaison AppSync de Legalesign. Votre client reçoit les événements dès qu’ils se produisent, sans avoir à faire de sondage.
Idéal pour :
- Applications frontend nécessitant des mises à jour instantanées de l’interface utilisateur
- Suivi en temps réel de la progression des téléchargements ou des envois
- Tout flux où vous maintenez déjà une connexion GraphQL
Pour commencer : Démarrage rapide des abonnements
Guides :
- Se connecter aux abonnements AppSync
- Suivre les tâches d’envoi
- Suivre la progression des téléchargements
- Suivre le cycle de vie des documents et des destinataires
Webhooks
Les webhooks envoient une requête HTTP POST vers une URL que vous configurez chaque fois qu’un événement survient. Aucune connexion persistante nécessaire — votre serveur gère simplement les requêtes entrantes.
Idéal pour :
- Intégrations backend et automatisation
- Systèmes derrière des pare-feux pouvant recevoir des requêtes HTTP mais ne pouvant pas maintenir de connexions WebSocket
- Flux de travail simples du type « prévenez-moi quand c’est terminé »
Pour commencer : Webhooks
Lequel devrais-je utiliser ?
| Abonnements | Webhooks | |
|---|---|---|
| Connexion | WebSocket persistante | HTTP POST par événement |
| Latence | Instantanée | Presque instantanée |
| Idéal pour | Applications frontend / interactives | Backend / automatisation |
| Authentification | Jeton SRP lors de la connexion | URL configurée + secret optionnel |
| Reconnexion | Le client se reconnecte | Legalesign réessaie en cas d’échec |
Vous pouvez utiliser les deux ensemble — par exemple, des abonnements pour mettre à jour votre interface utilisateur et des webhooks pour déclencher des workflows backend.