Aller au contenu
Livstick Développeurs
v3 Demander un accès

Accès et environnements

L’API Client ne propose pas d’inscription en libre-service. Livstick délivre directement les identifiants aux équipes et partenaires approuvés ; tout ce qui suit décrit ce que vous obtenez une fois l’accès accordé.

Avant de commencer

Les identifiants sont délivrés par l’équipe Livstick, et non créés via un formulaire sur ce site. Si vous n’en avez pas encore, demandez un accès développeur

Demander un accès

L’accès est accordé aux équipes et partenaires approuvés, une clé à la fois. Contactez-nous en précisant ce que vous construisez et l’API dont vous avez besoin : une clé est alors émise pour votre compte. Il n’y a ni liste d’attente ni formule à choisir.

Ce que vous recevez

Vous recevez une clé, accompagnée des informations qui déterminent ce qu’elle permet de faire et où elle fonctionne. Sa forme sur le réseau diffère selon l’API, mais pas ce qu’elle contient.

Ce qui accompagne une clé
Élément Signification
Une clé Envoyée sous la forme Authorization: Bearer liv_<prefix>_<secret> pour l’API v3, ou directement dans le chemin de l’URL pour l’API 2.1 — la même clé sous-jacente, présentée différemment par chaque API.
Scopes L’ensemble des opérations que la clé est autorisée à effectuer. La v3 accorde des scopes par famille d’opérations (containers:read, messages:write, etc.) ; la 2.1 accorde client_v2 ou user_v2 par famille de routes.
Une contrainte de plateforme En plus de ses scopes, une clé peut être limitée à une seule plateforme.

Cycle de vie d’une clé

Une clé n’est pas une chaîne statique remise une fois pour toutes. Elle porte un état qui évolue dans le temps, suivi de la même manière quelle que soit l’API visée.

  • Expiration — une clé peut avoir une date d’expiration.
  • Statut — active, révoquée ou expirée, vérifié à chaque requête.
  • Audit — chaque utilisation est enregistrée.
  • lastUsedAt — mis à jour à chaque utilisation de la clé.

URL de base

L’API v3 est servie depuis une URL de base fixe et publique. Ce n’est pas le cas de l’API 2.1 : son URL de base vous est communiquée avec votre accès.

text 
v3   https://client-api.v5.livstick.com/api/v3
2.1  provided with your access — not published here

Sandbox et données de test

Cette documentation ne propose d’environnement sandbox public pour aucune des deux API. Chaque exemple de ce site est conçu pour les URL de base ci-dessus, avec les identifiants qui vous ont été délivrés.