E-commerce — carte QR dans le colis

Comme pour tout conteneur à message unique : un crid, un message. Conservez tout de suite la valeur editKey de la réponse : elle n’est fournie qu’à la création.

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-456",
    "language": "en_us"
  }'

Transmettez les valeurs urid et editKey du conteneur que vous venez de créer. Le client enregistre sa vidéo avant de quitter la page. Aucun contact du destinataire n’est nécessaire dans ce parcours, puisque la remise passe par le colis et non par Livstick.

<livstick-widget-v2
  uid="{urid from step 1}"
  domain="example.com"
></livstick-widget-v2>
<script>
  const widget = document.querySelector("livstick-widget-v2");
  widget.editKey = "{editKey from step 1}";
</script>

Récupérez le QR code brut au format PNG si vous mettez en page votre propre carte, ou le PDF prêt à l’emploi si vous préférez la carte conçue par Livstick : son texte imprimé suit la langue définie sur le conteneur. Dans les deux cas, le QR code encode toujours l’URL de lecture destinée au destinataire, jamais un lien d’aperçu. Générez le fichier dès que votre chaîne logistique dispose du crid, puis transmettez-le au processus qui imprime ou insère la carte : son contenu ne change plus ensuite.

curl https://client-api.v5.livstick.com/api/v3/containers/ORDER-456/qrcode \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  --output qrcode.png

# or, for the ready-made PDF card:
curl https://client-api.v5.livstick.com/api/v3/containers/ORDER-456/card \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  --output card.pdf

Une fois la carte glissée dans le colis et celui-ci expédié, appelez unlock, et non notify. Ici, c’est vous qui assurez la remise, au moyen de la carte physique plutôt que d’un message envoyé par Livstick ; c’est unlock qui rend le message accessible à quiconque scanne le code.

curl -X POST https://client-api.v5.livstick.com/api/v3/containers/ORDER-456/unlock \
  -H "Authorization: Bearer {ACCESS_TOKEN}"