Skip to main content
En planlagt kørsel kalder din hostede app efter en cron i stedet for som svar på en request. Brug en til arbejde, som ingen Whop-hændelse udløser, f.eks. at hente nye ordrer fra et andet system hvert 15. minut eller afstemme udbetalinger i løbet af natten.

Angiv en tidsplan

En app har to tidsplaner. Angiv den ene eller begge med Update app:
Begge tager et cron-udtryk med fem felter, læst i UTC, på højst 64 tegn. Udtrykket skal udløses mindst én gang. schedule har intet minimumsinterval. Send null eller en tom streng for at rydde en tidsplan. Et ugyldigt udtryk returnerer 400. Nøglen skal have developer:update_app på den konto, der ejer appen.

Håndter kørslen

Eksporter scheduled() ved siden af fetch() i dit builds server-entry:
src/server.ts
ctx.props fortæller, hvilken kørsel det er: controller.cron er det udtryk, der planlagde kørslen, og controller.scheduledTime er tidsslottet i millisekunder siden epoch. En kørsel bruger samme isolate som dine request-handlere, så secrets og den indsatte API-nøgle fungerer på samme måde. En kørsel kan vare op til 15 minutter, hvor en request-handler får 30 sekunder.
Gem en synkroniseringscursor pr. installation i installationens metadata, som beskrevet i App-installationer. Hver kørsel læser den fra ctx.props.app_installation.metadata og skriver den nye værdi tilbage, når den er færdig.

Genforsøg og gentagne kørsler

Hvis en kørsel mislykkes, prøver Whop den igen én gang et minut senere og opgiver den derefter. For at springe genforsøget over skal du kalde controller.noRetry(), før du kaster en fejl. Ved genforsøget er attempt 2, og scheduled_at er stadig det oprindelige tidsslot. Det samme tidsslot kan nå din app mere end én gang, og et genforsøg kan starte, mens det næste tidsslots kørsel allerede er i gang. Hvis dit arbejde ikke må ske to gange, skal du registrere hver kørsel, du afslutter, under run_id plus app_installation.id og springe en kørsel over, som du allerede har registreret.

Oversprungne tidsslots

Der sker ingen kørsel, mens appen ikke har et web-build i produktion med en server-entry. Whop sætter ikke et oversprunget tidsslot i kø og indhenter det heller ikke senere, så byg hver kørsel, så den fortsætter fra det, den forrige gemte.

Logs

En kørsels console-output og ufangede fejl vises i din apps logs ved siden af dens requests.

Næste trin

App-installationer

Den installation, hver kørsel pr. installation medbringer, og hvor du gemmer en synkroniseringscursor.

Hosting

Builds, secrets, den indsatte API-nøgle og logs.