Développeurs d'enseignes OneSpan : Enregistrement d'une salle virtuelle - Partie 2

Dans la première partie de cette série de blogs, nous avons expliqué comment les enregistrements vidéo pouvaient améliorer l'utilité des preuves électroniques et garantir la conformité. Nous avons ensuite décrit le processus de configuration d'une transaction pour l'enregistrement dans une salle virtuelle.

Dans ce blog, nous allons montrer comment l'hôte peut être notifié lorsque les enregistrements vidéo sont prêts à être téléchargés et comment télécharger les enregistrements de manière programmatique. Sans plus attendre, commençons !

Notification par courriel de l'enregistrement vidéo

Une fois que tous les signataires ont terminé avec succès la transaction de la salle virtuelle, ils recevront instantanément un courriel de fin de transaction, comme dans le processus normal de signature, alors que les enregistrements vidéo seront toujours traités en coulisses.

Lorsque les enregistrements sont prêts à être téléchargés, l'hôte de la salle virtuelle en est informé par un autre courriel de notification ("email.virtual.room.recording") :

Le lien "GO TO RECORDINGS" conduira le propriétaire de la transaction à son portail d'expéditeur où il pourra se connecter et télécharger les enregistrements à partir de la page de détail de la transaction.

Il est important de noter que les enregistrements vidéo ne seront conservés sur le serveur de OneSpan Sign que pendant 7 jours après la fin de la transaction, c'est pourquoi le propriétaire de la transaction commencera à recevoir des e-mails de notification ("email.virtual.room.recording.reminder") trois jours avant leur retrait.

Les deux modèles d'e-mails sont entièrement personnalisables. Il vous suffit de modifier le contenu et d'envoyer le modèle d'e-mail au format HTML à notre équipe d'assistance pour qu'elle le configure dans votre compte.

Interroger l'état de l'enregistrement

Outre les notifications par courrier électronique, votre application peut également demander activement l'état des enregistrements de session. Afin de récupérer une liste des enregistrements de salles virtuelles disponibles pour une transaction donnée, il vous suffit d'utiliser l'API ci-dessous :

Requête HTTP

GET /virtual-room-video/{packageId}/recordings

En-têtes HTTP

Authorization : Basic api_key / Bearer access_token
Accept : application/json

Exemple de réponse

 [
  {
    "uid" : "a27a7763-2801-4fe7-b36b-009ea648ac67",
    "fileName" : "test_Virtual_Room_Recording-2022-04-29T16:22:12.mp4",
    "creationDate" : "2022-04-29T16:29:01Z",
    "fileSize" : "454703",
    "fileFormat" : "mp4",
    "status" : "enqueued",
    "md5Hash" : "879b1e9dc34680d9c7e526e6d2f0a569",
    "deletionDate" : "2022-05-07T02:30:00Z"
  },
  {
    "uid" : "c8719f57-fcb6-469d-b1f3-4ad231b16f61",
    "fileName" : "test_Virtual_Room_Recording-2022-04-29T16:30:49.mp4",
    "creationDate" : "2022-04-29T16:31:07Z",
    "fileSize" : "3065652",
    "fileFormat" : "mp4",
    "status" : "enqueued",
    "md5Hash" : "5b8a2d411e856fe68d8b4e28a1a5ca64",
    "deletionDate" : "2022-05-07T02:30:00Z"
  }
]

Après avoir reçu la réponse de l'API, notez qu'il y a trois statuts possibles : enqueued (en attente), completed (terminé) et deleted (supprimé). Pour les autres attributs, l'"uid" sera utilisé ultérieurement pour télécharger des vidéos individuelles, et vous pouvez également stocker le "fileSize" et le "md5Hash" pour vérifier l'intégrité des vidéos téléchargées.

Téléchargement de l'enregistrement vidéo

Lorsque l'enregistrement vidéo est terminé, vous pouvez récupérer le fichier vidéo par programme à l'aide de l'API ci-dessous :

Requête HTTP

GET /virtual-room-video/{packageId}/download-recording/{recording_uid}

En-têtes HTTP

Authorization : Basic api_key / Bearer access_token
Accept : application/json

Conclusion

Dans ce blog, nous vous avons présenté deux méthodes pour être informé du statut et télécharger les enregistrements vidéo. Dans la prochaine installation de cette série de blogs, nous approfondirons la prise en charge de la notification par rappel de la fonction de salle virtuelle. Si vous avez des questions concernant ce blog ou tout autre sujet relatif à l'intégration de OneSpan Sign dans votre application, visitez les forums de la communauté des développeurs. Vos commentaires nous intéressent !