Identifiants : crid, urid et editKey

Le crid est l’identifiant que vous choisissez lorsque vous créez un conteneur. C’est la clé de tous les appels serveur qui suivent : récupérer le conteneur, le mettre à jour, déclencher la remise, déverrouiller le message. Choisissez une valeur qui a déjà un sens dans votre système — un identifiant de commande, un identifiant de carte, un code figurant sur un emballage.

Créer un conteneur avec un crid qui existe déjà n’en crée pas un second et ne modifie pas le premier. Le serveur renvoie les liens du conteneur existant, tels qu’ils sont à cet instant.

Référence des conteneurs

L’opération qui crée un conteneur et renvoie ensemble le crid, l’urid et l’editKey.

L’urid est attribué par Livstick, pas par vous. C’est l’identifiant qui apparaît dans les URL, et celui sur lequel un widget se monte : le Recorder comme le Viewer prennent un urid, jamais un crid.

Choisir un mode d’intégration

Où le Recorder se monte sur un urid pour écrire un message.

Widget Viewer

Où le Viewer se monte sur un urid pour relire un message.

L’editKey donne un accès en écriture à un conteneur précis depuis du code côté client, sans exposer votre clé d’API. C’est ce qui permet au widget Recorder de fonctionner en toute sécurité sur une page publique.

Les trois identifiants côte à côte : qui choisit chacun d’eux et à quoi il sert.