Echtzeit-Ereignisse
Legalesign kann Ereignisse in Echtzeit an Ihre Anwendung senden – Dokument unterschrieben, Upload abgeschlossen, Senden fehlgeschlagen und so weiter. Es gibt zwei Mechanismen, und Sie können entweder einen oder beide verwenden.
Abonnements
GraphQL-Abonnements öffnen eine dauerhafte WebSocket-Verbindung zum Legalesign AppSync-Endpunkt. Ihr Client erhält Ereignisse, sobald sie eintreten, ohne dass Polling erforderlich ist.
Am besten geeignet für:
- Frontend-Apps, die sofortige UI-Updates benötigen
- Verfolgung des Upload- oder Sendefortschritts in Echtzeit
- Jeder Ablauf, bei dem bereits eine GraphQL-Verbindung besteht
So starten Sie: Subscriptions Quickstart
Anleitungen:
- Connect to AppSync Subscriptions
- Track Send Tasks
- Track Upload Progress
- Track Document & Recipient Lifecycle
Webhooks
Webhooks senden einen HTTP-POST an eine von Ihnen konfigurierte URL, wann immer ein Ereignis eintritt. Keine dauerhafte Verbindung nötig – Ihr Server verarbeitet einfach eingehende Anfragen.
Am besten geeignet für:
- Backend-Integrationen und Automatisierung
- Systeme hinter Firewalls, die HTTP empfangen, aber keine WebSocket-Verbindungen halten können
- Einfache "Benachrichtige mich, wenn fertig"-Workflows
So starten Sie: Webhooks
Welches sollte ich verwenden?
| Abonnements | Webhooks | |
|---|---|---|
| Verbindung | Dauerhafte WebSocket-Verbindung | HTTP POST pro Ereignis |
| Latenz | Sofort | Nahezu sofort |
| Am besten für | Frontend / interaktive Apps | Backend / Automatisierung |
| Auth | SRP-Token bei Verbindung | Konfigurierte URL + optionales Geheimnis |
| Wiederholung | Client verbindet sich erneut | Legalesign wiederholt bei Fehler |
Sie können beide zusammen verwenden – zum Beispiel Abonnements, um Ihre UI zu aktualisieren, und Webhooks, um Backend-Workflows auszulösen.