Déclencheurs d’Actions : objet API custom-phone-provider

api.cache

Stockez et récupérez des données qui persistent entre les exécutions.

api.cache.delete(key)

Supprimez un enregistrement décrivant une valeur mise en cache sous la clé fournie, le cas échéant.

Renvoie un objet CacheWriteResult avec le type : "success" si une valeur a été supprimée du cache. Une opération qui a échoué renvoie le type : "error". En cas d’erreur, l’objet renvoyé affichera une propriété code qui indique la nature de l’échec.

api.cache.get(key)

Récupérez un enregistrement décrivant une valeur mise en cache sous la clé, le cas échéant. Si un enregistrement est trouvé, la valeur mise en cache peut être trouvée dans la propriété valeur de l’objet retourné.

Renvoie un enregistrement si un élément est trouvé dans le cache sous la key fournie. Les enregistrements de cache sont des objets dotés d’une propriété value contenant la valeur mise en cache et d’une propriété expires_at indiquant l’heure d’expiration maximale de l’enregistrement, en millisecondes depuis l’époque Unix.

Important : Ce cache est conçu pour des données éphémères de courte durée. Certains éléments peuvent ne pas être disponibles lors de transactions ultérieures, même s’ils sont encore dans la limite de leur durée de vie.

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

Stockez ou mettez à jour la valeur d’une chaîne dans le cache sous la clé spécifiée.

Les valeurs stockées dans ce cache sont limitées au déclencheur dans lequel elles sont définies. Elles sont soumises aux Limites de cache des actions.

Les valeurs stockées de cette manière auront des durées de vie allant jusqu’aux valeurs ttl ou expires_at spécifiées. Si aucune durée de vie n’est spécifiée, elle sera de 15 minutes par défaut. Les durées de vie ne doivent pas dépasser la durée maximale indiquée dans : Limites de caches des actions.

Numéro facultatif. Valeur de la durée de vie de cette entrée de cache en millisecondes. Bien que les valeurs mises en cache puissent être expulsés plus tôt, elles ne resteront jamais au-delà de la valeur ttl fournie.

Remarque : Cette valeur ne doit pas être fournie si une valeur a également été donnée pour expires_at. La première des deux échéances sera retenue si les deux options sont fournies.

api.notification

Indique si l’événement notifié devrait être réessayé ou abandonné. Consultez chacune de ces méthodes pour obtenir plus de détails sur le comportement réel. Si plusieurs appels sont effectués, seul le dernier événement de notification sera pris en compte.

api.notification.drop(reason)

Lorsqu’il est appelé, l’événement de notification est considéré comme un échec sans possibilité de récupération.

Nous enregistrerons une erreur pour cet événement (fn), mais nous ne l’enverrons plus à l’action à l’avenir.

Si vous avez besoin de réessayer cet événement de notification, envisagez plutôt d’appeler api.notification.retry.

api.notification.retry(reason)

Lorsqu’il est appelé, l’événement de notification est considéré comme un échec avec possibilité de récupération.

Nous enregistrerons une erreur pour cet événement (fn), mais nous le réessaierons jusqu’à cinq fois dans les prochaines minutes.

Si vous estimez que cet événement de notification ne doit pas être réessayé, envisagez plutôt d’appeler api.notification.drop.