Qu’est-ce qu’une Assembly Notification ?
Une Assembly Notification Transloadit est une requête POST facultative envoyée à une URL spécifiée une fois qu’une Assembly est terminée. Sa charge utile contient l’Assembly Status qui en résulte.
Fonctionnement des Assembly Notifications
Une notification est un envoi de serveur à serveur signalant la fin du traitement, qui transmet la représentation finale du traitement à un point de terminaison applicatif. Elle dissocie le traitement des médias de la durée de vie de la connexion HTTP d’origine et convient donc aux processus durables en arrière-plan. Le récepteur devrait vérifier l’authenticité, enregistrer durablement l’identité de l’exécution et n’accuser réception qu’après une prise en charge sûre. Les modalités de livraison exigent également une logique métier qui gère les doublons sans effet indésirable, plutôt que de supposer qu’une seule requête sera reçue.
Points clés
- 1Le corps de la notification contient les données de statut de l’Assembly, ce qui permet au récepteur de corréler l’événement, d’examiner l’issue finale et de localiser les résultats sans maintenir ouverte la requête de téléversement.
- 2Si la réponse du point de terminaison de rappel n’indique pas un succès, une nouvelle tentative de livraison peut avoir lieu. Les effets de bord, tels que la publication ou la facturation, nécessitent donc un mécanisme d’idempotence indexé par Assembly.
- 3La destination étant une URL contrôlée par l’application, la disponibilité du point de terminaison, la configuration TLS, les vérifications d’authentification et la latence de réponse influent toutes sur la fiabilité de la transmission.
Quand les Assembly Notifications comptent
Utilisez les notifications plutôt que des interrogations continues lorsqu’un système peut recevoir des événements asynchrones de fin de traitement. Mettez en place l’authentification et rendez le récepteur idempotent, car les requêtes falsifiées ou répétées ne doivent pas entraîner de traitement en double.