Was ist eine Assembly Notification?
Eine Transloadit Assembly Notification ist eine optionale POST-Anfrage, die nach Abschluss einer Assembly an eine angegebene URL gesendet wird. Ihre Nutzlast enthält den daraus resultierenden Assembly Status.
So funktionieren Assembly Notifications
Eine Assembly Notification übermittelt nach Abschluss einer Verarbeitung die abschließende Darstellung des Verarbeitungsauftrags von Server zu Server an einen Anwendungsendpunkt. Sie entkoppelt die Medienverarbeitung von der Lebensdauer der ursprünglichen HTTP-Verbindung und eignet sich daher für dauerhafte Hintergrundabläufe. Der Empfänger sollte die Authentizität prüfen, die Ausführungskennung dauerhaft speichern und den Empfang erst nach sicherer Verarbeitung bestätigen. Die Zustellungssemantik erfordert zudem Geschäftslogik, die Duplikate sicher handhabt, statt von einer einzigen Anfrage auszugehen.
Wichtige Fakten
- 1Der Anfragekörper einer Assembly Notification enthält die Statusdaten der Assembly. So kann ein Empfänger das Ereignis zuordnen, das endgültige Ergebnis prüfen und die Ergebnisdateien finden, ohne die Upload-Anfrage offen zu halten.
- 2Eine nicht erfolgreiche Antwort vom Callback-Endpunkt kann zu einem weiteren Zustellversuch führen. Deshalb benötigen Seiteneffekte wie Veröffentlichung oder Abrechnung einen Idempotenzschutz, der an die jeweilige Assembly gebunden ist.
- 3Da das Ziel eine von der Anwendung kontrollierte URL ist, beeinflussen die Verfügbarkeit des Endpunkts, die TLS-Konfiguration, Authentifizierungsprüfungen und die Antwortlatenz gemeinsam die zuverlässige Übergabe.
Wann Assembly Notifications wichtig sind
Verwenden Sie Assembly Notifications statt kontinuierlichem Polling, wenn ein System asynchrone Abschlussereignisse empfangen kann. Prüfen Sie die Authentizität der Anfragen und gestalten Sie den Empfänger idempotent, denn gefälschte oder wiederholte Anfragen dürfen keine Arbeit doppelt auslösen.