Skip to main content
Zamanlanmış bir çalıştırma, barındırılan uygulamanızı bir isteğe yanıt olarak değil, bir cron ile çağırır. Bunu, hiçbir Whop olayının tetiklemediği işler için kullanın; örneğin her 15 dakikada bir başka bir sistemden yeni siparişleri çekmek veya para çekmelerin mutabakatını gece boyunca yapmak.

Bir zamanlama ayarlayın

Bir uygulamanın iki zamanlaması vardır. Birini veya ikisini Uygulamayı güncelle ile ayarlayın:
Her ikisi de UTC olarak okunan, en fazla 64 karakterlik beş alanlı bir cron ifadesi alır. İfadenin en az bir kez tetiklenmesi gerekir. schedule için minimum aralık yoktur. Bir zamanlamayı temizlemek için null veya boş bir dize gönderin. Geçersiz bir ifade 400 döndürür. Anahtarın, uygulamanın sahibi olan hesapta developer:update_app iznine sahip olması gerekir.

Çalıştırmayı ele alın

Derlemenizin sunucu giriş noktasında fetch() fonksiyonunun yanına scheduled() fonksiyonunu dışa aktarın:
src/server.ts
ctx.props bunun hangi çalıştırma olduğunu belirtir: controller.cron çalıştırmayı zamanlayan ifadedir; controller.scheduledTime ise epoch’tan bu yana milisaniye cinsinden zaman dilimidir. Bir çalıştırma, istek işleyicilerinizle aynı izolatı kullanır; bu nedenle gizli anahtarlar ve enjekte edilen API anahtarı aynı şekilde çalışır. Bir istek işleyicisi 30 saniye alırken, bir çalıştırma 15 dakikaya kadar sürebilir.
Uygulama kurulumları sayfasında açıklandığı gibi, kurulum başına bir senkronizasyon imlecini kurulumun metadata alanında tutun. Her çalıştırma bunu ctx.props.app_installation.metadata üzerinden okur ve bittiğinde yeni değeri geri yazar.

Yeniden denemeler ve tekrarlanan çalıştırmalar

Bir çalıştırma başarısız olursa Whop bunu bir dakika sonra bir kez yeniden dener, ardından bırakır. Yeniden denemeyi atlamak için hata fırlatmadan önce controller.noRetry() çağırın. Yeniden denemede attempt değeri 2 olur ve scheduled_at hâlâ orijinal zaman dilimidir. Aynı zaman dilimi uygulamanıza birden fazla kez ulaşabilir ve bir yeniden deneme, bir sonraki zaman diliminin çalıştırması zaten devam ederken başlayabilir. İşinizin iki kez gerçekleşmemesi gerekiyorsa, tamamladığınız her çalıştırmayı run_id ve app_installation.id altında kaydedin ve zaten kaydettiğiniz bir çalıştırmayı atlayın.

Atlanan zaman dilimleri

Uygulamanın sunucu giriş noktasına sahip bir üretim web derlemesi yokken hiçbir çalıştırma gerçekleşmez. Whop, atladığı bir zaman dilimini kuyruğa almaz veya daha sonra telafi etmez; bu nedenle her çalıştırmayı, bir öncekinin kaydettiği yerden devam edecek şekilde oluşturun.

Günlükler

Bir çalıştırmanın console çıktısı ve yakalanmamış hataları, uygulamanızın günlüklerinde isteklerinin yanında görünür.

Sonraki adımlar

Uygulama kurulumları

Kurulum başına her çalıştırmanın taşıdığı kurulum ve bir senkronizasyon imlecinin nerede tutulacağı.

Barındırma

Derlemeler, gizli anahtarlar, enjekte edilen API anahtarı ve günlükler.