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
Exportezscheduled() à 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.
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, appelezcontroller.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 sortieconsole 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.

