Skip to main content
Une exécution planifiée appelle votre application hébergée selon un cron plutôt qu’en réponse à une requête. Utilisez-en une pour les tâches qu’aucun événement Whop ne déclenche, comme récupérer les nouvelles commandes d’un autre système toutes les 15 minutes ou rapprocher les versements pendant la nuit.

Définir une planification

Une application dispose de deux planifications. Définissez l’une ou les deux avec Update app :
Les deux acceptent une expression cron à cinq champs, interprétée en UTC, d’au plus 64 caractères. L’expression doit se déclencher au moins une fois. schedule n’a pas d’intervalle minimal. Envoyez null ou une chaîne vide pour supprimer une planification. Une expression invalide renvoie une erreur 400. La clé doit disposer de developer:update_app sur le compte propriétaire de l’application.

Gérer l’exécution

Exportez scheduled() à côté de fetch() dans le point d’entrée serveur de votre build :
src/server.ts
ctx.props indique de quelle exécution il s’agit : controller.cron est l’expression qui a planifié l’exécution, et controller.scheduledTime est le créneau en millisecondes depuis l’epoch. Une exécution utilise le même isolat que vos gestionnaires de requêtes : les secrets et la clé API injectée fonctionnent donc de la même manière. Une exécution peut durer jusqu’à 15 minutes, alors qu’un gestionnaire de requêtes dispose de 30 secondes.
Conservez un curseur de synchronisation par installation dans les metadata de l’installation, comme décrit dans Installations d’application. Chaque exécution le lit depuis ctx.props.app_installation.metadata et réécrit la nouvelle valeur à la fin.

Nouvelles tentatives et exécutions répétées

Si une exécution échoue, Whop la relance une fois, une minute plus tard, puis l’abandonne. Pour ignorer la nouvelle tentative, appelez controller.noRetry() avant de lever une exception. Lors de la nouvelle tentative, attempt vaut 2 et scheduled_at reste le créneau d’origine. Le même créneau peut atteindre votre application plusieurs fois, et une nouvelle tentative peut démarrer alors que l’exécution du créneau suivant est déjà en cours. Si votre tâche ne doit pas se produire deux fois, enregistrez chaque exécution terminée sous run_id plus app_installation.id, et ignorez toute exécution déjà enregistrée.

Créneaux ignorés

Aucune exécution n’a lieu tant que l’application n’a pas de build web de production avec un point d’entrée serveur. Whop ne met pas en file d’attente un créneau ignoré et ne le rattrape pas plus tard : concevez donc chaque exécution pour qu’elle reprenne là où la précédente s’est arrêtée.

Journaux

La sortie console d’une exécution et ses erreurs non interceptées apparaissent dans les journaux de votre application, à côté de ses requêtes.

Étapes suivantes

Installations d'application

L’installation portée par chaque exécution par installation, et l’endroit où conserver un curseur de synchronisation.

Hébergement

Builds, secrets, clé API injectée et journaux.