Zamanlanmış URL sorgulama

Bir webhook normalde birinin onu çağırmasını bekler. Zamanlama özelliği kullanıldığında ise çağrıyı uygulama yapar: belirlediğiniz bir URL’yi sabit aralıklarla alır ve yanıtı aynı webhook’a gönderir; böylece Shopify Flow iş akışınız, JSON, form verileri veya XML döndüren herhangi bir API’den zamanlayıcıyla çalışır.

Tipik kullanım örnekleri: Bir tedarikçinin stok verilerini her 15 dakikada bir almak, bir ERP sisteminde yeni siparişleri her saat başı kontrol etmek veya bir durum uç noktasını günde bir kez okumak ve Shopify Flow'un buna göre işlem yapmasını sağlamak.

Bir tane kurmak

Yeni bir webhook oluşturmak için Webhook oluştur seçeneğini seçin ve “Bu webhook’u ne tetikleyecek?” sorusuna Hiçbir şey - zamanlanmış olarak çalıştır seçeneğini seçin. Webhook, gizli bir jetonla oluşturulur; böylece başka hiç kimse URL'sini çağıramaz ve "Zamanlama" sekmesi açılır. Zaten sahip olduğunuz bir webhook için, onu açın ve Zamanlama sekmesine gidin. Ardından şu bilgileri girin:

Alan	Ne işe yarar?
Etkinleştirildi	Zamanlamayı etkinleştirir. Webhook URL’si her iki durumda da çalışmaya devam eder.
URL	Alınacak adres. Yalnızca http ve https adresleri kabul edilir ve bu adresin genel internet üzerinden erişilebilir olması gerekir.
Aralık	Her 5, 15 veya 30 dakikada bir, her 1, 3, 6 veya 12 saatte bir ya da günde bir kez.
Mod	Her get işlemi, her çalıştırmada Shopify Flow’u tetikler. Yalnızca yanıt değiştiğinde, yani gövde bir önceki çalıştırmadan farklı olduğunda tetiklenir.
İstek başlıkları	İsteğe bağlıdır; API anahtarı veya taşıyıcı jetonu için kullanılır. Şifrelenmiş olarak saklanır ve bir daha asla gösterilmez.

İlk çalıştırma, özelliğin etkinleştirilmesinden sonraki bir dakika içinde gerçekleşir.

Tepkinin haritalandırılması

Alınan veri, tıpkı birinin size gönderdiği bir istek gibi webhook’tan geçer: içerik türüne göre ayrıştırılır, alan eşlemeniz Shopify Flow’un alacağı değerleri belirler ve ayarlanmışsa dizi bölme işlemi uygulanır.

API kendi yanıt biçimini kendisi belirlediği için, zamanlanmış işlemler, kendi sistemleriniz tarafından gönderilen JSON için geçerli olan “beklenmeyen alanlar” kontrolünü atlar. Yalnızca sizin için önemli olan değerleri eşleştirmeniz yeterlidir.

{
  "updated_at": "2026-09-17T08:00:00Z",
  "items": [
    { "sku": "ABC-1", "stock": 4 },
    { "sku": "ABC-2", "stock": 0 }
  ]
}

updated_at öğesini bir Shopify Flow alanına eşleştirerek iş akışınızda kullanabilirsiniz. Her bir öğeyi ayrı ayrı işlemek için, Gelişmiş Ayarlar altındaki bölme yolunu items olarak ayarlayın; böylece her bir öğe kendi Shopify Flow çalıştırmasını tetikler. Bkz. Vücut biçimleri ve dizilerin bölünmesi.

Şimdi çalıştır

"Şimdi çalıştır" seçeneği, anında gerçek bir çalıştırma işlemi gerçekleştirir: URL’yi alır, size HTTP durumunu, yanıt önizlemesini ve ne olduğunu (tetiklendi, değişmedi veya hata) gösterir; yanıt kullanılabilirse Shopify Flow’u tetikler. Bir sonraki aralığı beklemek yerine, URL’yi veya başlıkları değiştirdikten sonra bu seçeneği kullanın.

Ancak yanıt değiştiğinde

Bu modda uygulama, alınan gövdeyi bir öncekiyle karşılaştırır ve yalnızca farklılık olduğunda Shopify Flow’u tetikler. Stok veya durum akışı gibi, gerçek bir değişiklik olana kadar aynı belgeyi döndüren uç noktalar için bu modu kullanın. Karşılaştırma gövdenin tamamı üzerinde yapılır; bu nedenle, her yanıtta zaman damgası veya istek kimliği içeren bir API, her seferinde farklı görünecektir.

Bir zaman çizelgesi başarısız olduğunda

Sekmedeki Durum bloğu, son çalıştırmayı, son HTTP durumunu, bir sonraki çalıştırmayı ve son hatayı gösterir.

• Bir ağ hatası, 2xx serisi dışındaki bir durum kodu veya ayrıştırılamayan bir istek gövdesi, işlem hatası olarak kabul edilir ve Shopify Flow’u tetiklemez.
• **Arka arkaya 20 kez başarısızlık **yaşandıktan sonra, program sonsuza kadar çalışmayan bir URL’yi çağırmak yerine, kendisi duraklatılır ve bunu bildirir. URL’yi veya kimlik bilgilerini düzeltin ve programı yeniden etkinleştirin.
• Plan sınırınıza ulaşmanız bir hata olarak değerlendirilmez. Bu çalıştırmalar engellenir ve kontrol panelinde gösterilir.

Uygulamanın almayacağı şeyler

Yalnızca genel adresler kabul edilir. Dahili ve özel adresler (localhost, özel adres aralıkları, bulut meta veri uç noktaları), bir yönlendirmenin bu tür bir adrese işaret etmesi durumunda da dahil olmak üzere reddedilir. Yanıtların boyutu 1 MB ile sınırlıdır ve yanıt süresi 10 saniyeyi geçemez; ayrıca en fazla 3 yönlendirmeye izin verilir. Bir yönlendirme farklı bir siteye yönlendiriyorsa, başlıklarınız silinir.

Zamanlanmış işlerin nerede göründüğü

History'de, kaynak olarak Scheduled seçildiğinde. Diğer her şey her zamanki gibi çalışıyor: veri yükü, Shopify Flow tetikleyici sonucu, yeniden denemeler ve tekrar oynatma.