Eventi in tempo reale
Legalesign può inviare eventi alla tua applicazione in tempo reale — documento firmato, caricamento completato, invio fallito, e così via. Ci sono due meccanismi, e puoi usarne uno o entrambi.
Sottoscrizioni
Le sottoscrizioni GraphQL aprono una connessione WebSocket persistente all'endpoint AppSync di Legalesign. Il tuo client riceve gli eventi mentre accadono, senza polling.
Ideale per:
- App frontend che necessitano di aggiornamenti istantanei dell'interfaccia utente
- Tracciare il progresso di caricamento o invio in tempo reale
- Qualsiasi flusso in cui stai già mantenendo una connessione GraphQL
Inizia qui: Subscriptions Quickstart
Guide:
- Connect to AppSync Subscriptions
- Track Send Tasks
- Track Upload Progress
- Track Document & Recipient Lifecycle
Webhook
I webhook inviano un HTTP POST a un URL che configuri ogni volta che si verifica un evento. Non serve una connessione persistente — il tuo server si occupa semplicemente delle richieste in arrivo.
Ideale per:
- Integrazioni backend e automazioni
- Sistemi dietro firewall che possono ricevere HTTP ma non mantenere connessioni WebSocket
- Flussi di lavoro semplici "avvisami quando finito"
Inizia qui: Webhooks
Quale dovrei usare?
| Sottoscrizioni | Webhook | |
|---|---|---|
| Connessione | WebSocket persistente | HTTP POST per evento |
| Latenza | Istantanea | Quasi istantanea |
| Ideale per | App frontend / interattive | Backend / automazione |
| Autenticazione | Token SRP alla connessione | URL configurato + segreto opzionale |
| Ritenti | Il client si riconnette | Legalesign ritenta in caso di fallimento |
Puoi usare entrambi insieme — ad esempio, sottoscrizioni per aggiornare la tua UI e webhook per attivare flussi di lavoro backend.