Afficher un message avec le Viewer
Retrouvez un message déjà enregistré, vérifiez qu’il est libéré (released), puis transmettez son URL à votre expérience de destination.
Prérequis
Un conteneur dont l’étape Recorder est déjà terminée, et son crid — voir Intégrer le widget Recorder.
Consulter le conteneur
GET /containers/{crid} (scope containers:read) renvoie l’état actuel du conteneur ainsi que celui du message — pending_release, released, delivery_triggered ou unknown.
curl https://client-api.v5.livstick.com/api/v3/containers/{crid} \
-H "Authorization: Bearer {ACCESS_TOKEN}"
Vérifier que le message est libéré
Si vous suivez déjà l’identifiant propre du message, GET /messages/{messageId} (scope messages:read) renvoie son détail complet, y compris le même champ state. Ne passez à la suite que lorsque state vaut released.
curl https://client-api.v5.livstick.com/api/v3/messages/{messageId} \
-H "Authorization: Bearer {ACCESS_TOKEN}"
Récupérer l’URL de lecture
GET /containers/{crid}/url (scope containers:read) renvoie recordingUrl et previewUrl pour le conteneur.
curl https://client-api.v5.livstick.com/api/v3/containers/{crid}/url \
-H "Authorization: Bearer {ACCESS_TOKEN}"
Présenter le message dans votre expérience de destination
recordingUrl est un lien complet et partageable : transmettez-le directement à la surface qui affiche le message, sous forme de simple lien ou intégré à votre propre page.
<a href="{recordingUrl}">Watch the message</a>
Étapes suivantes
Pour comprendre les liens entre conteneurs, codes et messages — et pourquoi un message ne peut être affiché qu’une fois libéré —, lisez « Conteneurs et messages ».