Objet API

Découvrez l’objet API du déclencheur d’Action send-phone-message.

L’objet API du déclencheur d’Action send-phone-message comprend :

​

api.cache

Stockez et récupérez des données conservées d’une exécution à l’autre.

​

api.cache.delete(key)

Supprime l’enregistrement associé à la valeur mise en cache à la clé fournie, s’il existe.

Paramètres

Masquer Paramètres

key · string

La clé de l’enregistrement du cache à supprimer.

​

api.cache.get(key)

Récupère l’enregistrement associé à la valeur mise en cache sous la clé fournie, s’il existe. Si un enregistrement est trouvé, la valeur mise en cache se trouve dans la propriété value de l’objet renvoyé.

Paramètres

Masquer Paramètres

key · string

La clé de l’enregistrement stocké dans le cache.

​

api.cache.set(key, value, options)

Stocke ou met à jour une valeur de type chaîne dans le cache à la clé indiquée.

Les valeurs stockées dans ce cache sont limitées au Trigger dans lequel elles sont définies. Elles sont assujetties aux limites du cache d’Actions.

Les valeurs stockées de cette façon auront une durée de vie pouvant atteindre les valeurs ttl ou expires_at indiquées. Si aucune durée de vie n’est précisée, une durée de vie par défaut de 15 minutes sera utilisée. Les durées de vie ne peuvent pas dépasser la durée maximale indiquée dans les limites du cache d’Actions.

Important : Ce cache est conçu pour des données éphémères de courte durée. Les éléments pourraient ne pas être disponibles dans des transactions ultérieures, même s’ils n’ont pas encore atteint la fin de leur durée de vie.

Paramètres

Masquer Paramètres

key · string

La clé de l’enregistrement à stocker.

value · string

La valeur de l’enregistrement à stocker.

options · cachesetoptions

Options permettant d’ajuster le comportement du cache. Facultatif.

Afficher propriétés d’options

expires_at · number

L’heure d’expiration absolue, en millisecondes depuis l’époque Unix. Même si les enregistrements mis en cache peuvent être évincés plus tôt, ils ne seront jamais conservés au-delà de la valeur expires_at fournie.

Remarque : Cette valeur ne doit pas être fournie si une valeur a également été fournie pour ttl. Si les deux options sont fournies, la date d’expiration la plus rapprochée sera utilisée. Facultatif.

ttl · number

La durée de vie de cette entrée de cache, en millisecondes. Même si les valeurs mises en cache peuvent être évincées plus tôt, elles ne seront jamais conservées au-delà de la valeur ttl fournie.

Remarque : Cette valeur ne doit pas être fournie si une valeur a également été fournie pour expires_at. Si les deux options sont fournies, la date d’expiration la plus rapprochée sera utilisée. Facultatif.