Effectuer votre première requête API

API v3 — Actuelle ≈ 10 minutes

Créez votre premier conteneur, puis récupérez l’URL utilisée par l’étape suivante de votre parcours — le flux par lequel commence toute intégration Livstick.

Prérequis

Un jeton d’accès fourni par l’équipe Livstick. Si vous n’en avez pas encore, demandez un accès développeur.

Créer un conteneur

Un conteneur porte le message vidéo et ses paramètres de remise. Le crid est votre propre référence métier — un numéro de commande, un code de carte — et c’est le seul champ obligatoire.

POST /containers

curl -X POST https://client-api.v5.livstick.com/api/v3/containers \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ "crid": "ORDER-123", "language": "en_us" }'

Récupérer l’URL de partage

Appelez cet endpoint avec le crid choisi à l’étape 1.

GET /containers/{crid}/url

curl https://client-api.v5.livstick.com/api/v3/containers/{crid}/url \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Étapes suivantes

Avec un conteneur et son URL, vous pouvez intégrer le widget Recorder dans votre propre parcours, ou transmettre l’URL au mode de remise que vous avez choisi.