Aller au contenu
Demander une démoDémo

Intégration

Créé depuis votre checkout. Remis à votre signal.

Avec l’API Livstick, votre checkout ou votre CRM crée le cadeau, obtient son lien d’enregistrement, déclenche la remise et en suit le statut.

Parler de votre intégration Comment ça marche
  • API REST, clé Bearer
  • Neuf scopes
  • Spécification OpenAPI 3.1
Un ingénieur logiciel explique une intégration de cadeau vidéo, devant un ordinateur portable et un cadeau Créé depuis votre checkout
maison lune

Enregistrez quelques mots pour Camille.

Touchez pour enregistrer
message.gift · propulsé par Livstick
L’URL renvoyée
Lien d’enregistrement prêt
containers.http API v3 
POST /api/v3/containersAuthorization: Bearer liv_a1b2c3_••••••••••••{ "crid": "ORDER-48219",  "language": "fr",  "recipient": { "firstName": "Camille",    "channel": "email" } }201 Created{ "crid": "ORDER-48219",  "url": "…/record",  "urlPreview": "…/preview" }

Votre référence de commande entre, le lien d’enregistrement revient.

Où elle intervient

Le cadeau naît dans le système qui a pris la commande.

Un checkout, un système de commande ou un CRM connaît la référence, l’acheteur, le destinataire et la langue bien avant qu’on pense à la vidéo.

  1. Enregistrer L’expéditeur filme
  2. Vérifier Retenu pour une personne
  3. Remettre Le conteneur s’ouvre La bibliothèque d’API intervient iciIci
  4. Révéler Le destinataire le regarde

  • Commande et checkout

    Un appel crée le conteneur ; le lien d’enregistrement, le QR code et la carte PDF suivent.

  • Remise

    Un appel explicite : votre logistique, votre date, votre moment.

  • État relu

    Listez les conteneurs, lisez un message, gardez votre base à jour.

  • Clés et audit

    Chaque appel est journalisé. Un scope manquant donne un refus, jamais un échec silencieux.

Comment ça marche

Trois appels. Votre logique décide du moment.

  1. containers.http 
    POST /api/v3/containers{ "crid": "ORDER-48219" }# 201 → url, urlPreview

    Créer

    Un appel crée le conteneur avec votre propre référence de commande.

  2. Maison Lune 09:12

    Camille, un message accompagne votre cadeau

    Quelqu’un a enregistré quelques mots pour vous.

    Lire le message

    Remettre

    Quand votre logique le décide : Livstick prévient le destinataire, ou votre propre canal débloque le message.

  3. ORDER-48219 API v3
    Léa → Camille Vidéo · 0:24 released
    Conteneur
    recording_closed
    Message
    released

    Relire

    Les états du conteneur et du message reviennent sous votre référence.

Bon à savoir

Ce que l’API contrôle à chaque requête.

Une intégration se planifie sur des contraintes, pas sur des adjectifs.

  • Une clé, une plateforme

    Une clé cible une seule plateforme, et l’API refuse toutes les autres. Prévoyez-en une par marque et par environnement.

  • Des scopes, pas du tout ou rien

    Les droits s’accordent par famille d’opérations. Une intégration en lecture seule ne peut pas créer de conteneur, par construction.

  • 1 000 requêtes par quart d’heure et par clé

    Le même plafond sur la v3 et la 2.1. Les traitements en masse, tirage d’impression ou rapprochement nocturne, gagnent à être étalés.

  • Des clés délivrées, pas en libre-service

    Ni inscription en libre-service, ni bac à sable public : notre équipe crée, renouvelle et révoque les clés.

    Sur demande

Deux intégrations qui ne se ressemblent pas.

ORDER-48219 Votre système
  1. 23:40 Conteneur créé
  2. 23:52 Message enregistré
  3. J+2 Colis expédié · appel de remise
Checkout e-commerce

Acheté à 23 h 40, enregistré avant l’expédition.

Le numéro de commande sert de référence. La remise part quand le colis quitte l’entrepôt : la vidéo arrive avec le cadeau.

MAISON LUNE 50 €
Carte PDF prête
Programme de cartes cadeaux

Dix mille cartes, chacune avec son emplacement de message.

Votre système récupère la carte PDF ou le QR code de chaque conteneur pour l’impression, puis suit l’activation carte par carte.

Marques et messages fictifs, pour l’illustration.

Ils ont déjà mis une voix dans leurs cadeaux.

Luxe, beauté, retail et fleurs

FAQ

Clés, limites et versions, dans cet ordre.

Comment obtenir une clé d’API ?

Livstick la délivre, pour les intégrations validées. Dites-nous ce que vous construisez et de quelle API vous avez besoin.

Une clé peut-elle servir plusieurs marques ou environnements ?

Non. Une clé cible une seule plateforme, et c’est vérifié à chaque requête, pas laissé à une convention.

Quelles sont les limites de débit ?

1 000 requêtes par quart d’heure et par clé, à l’identique sur la v3 et la 2.1. Une limite globale par adresse IP s’applique en amont de l’authentification.

Plusieurs versions de l’API : laquelle choisir ?

Partez sur la v3, l’API actuelle. La v3.1, réservée aux plateformes V3, ajoute des conteneurs dont le mode est fixé à la création, vos propres références de message (mrid) et des webhooks signés. L’API 2.1 reste servie pour les intégrations existantes, rien ne presse donc côté migration, mais elle place la clé dans le chemin de l’URL et ses droits sont bien moins fins.

Publiez-vous des SDK ?

Pas aujourd’hui. Chaque version de l’API publie sa propre spécification OpenAPI : vous pouvez générer un client dans votre langage.

Vos systèmes connaissent déjà le bon moment. Donnez-leur l’API.

Parler de votre intégration