Geçmiş ve sorun giderme

Sayfayı kopyala

Çağrı geçmişini inceleyin, her reddetme kodunu anlayın, Canlı İstek Denetleyicisi’ni kullanın ve geçmiş olayları yeniden oynatın.

Bir webhook’a ulaşan her istek, kabul edilmiş ya da reddedilmiş olsun, kaydedilir. Bir şey gerçekleşmediğinde ilk olarak geçmişe bakılmalıdır.

Bir dua okuma

Geçmişi açın ve bir girişi tıklayın. Zaman damgası, durum, çağrı kaynağı, süre, veri yükü, (maskelenmiş) istek başlıkları, sorgu dizesi ve hata durumlarında hata mesajı ile her yeniden deneme girişimini görebilirsiniz.

Durum	Anlamı
Beklemede	Kabul edildi ve kuyruğa alındı, henüz Shopify Flow’a aktarılmadı
Başarı	Shopify Flow, tetikleyiciyi kabul etti
Başarısız	Teslimat kalıcı olarak başarısız oldu - nedenini ayrıntılar sayfasında görebilirsiniz

Invoked by sütunu, çağrının nereden geldiğini gösterir: User (harici bir sistem), Flow (webhook’u çağıran bir Shopify Flow eylemi), Test (Test düğmesi) veya CURL.

Webhook Geçmişi, tek bir webhook'a göre filtrelenmiş; durum olarak “Başarılı” ve kaynak olarak “Harici Sistem” olan çağrıları listeliyor — Webhook Geçmişi, tek bir webhook'a göre filtrelenmiş. Her istek, durumu ve geldiği yer ile birlikte listelenmiştir.

Tarih bölümünde, istek başlıkları, veri yükü, durum, süre ve tanımlayıcılarıyla birlikte bir çağrı açıldı — Bir çağrı, açılmış hali: istek başlıkları (jeton gizlenmiştir), veri yükü, işlemin süresi ve sağ üst köşedeki “Replay Webhook” seçeneği.

Reddedilmeler ve her birinin anlamı

Reddedilen bir istek hiçbir zaman Shopify Flow’a ulaşmaz. Yanıt gövdesinde, makine tarafından okunabilir bir code bulunur:

Kod	HTTP	Neler ters gitti?	Düzelt
`webhook_not_found`	404	Kısa kod bilinmiyor	URL’yi kontrol edin; webhook silinmiş olabilir
`webhook_disabled`	400	Webhook devre dışı bırakılmıştır	Webhook sayfasında bunu etkinleştirin
`unauthorized`	401	Jeton eksik veya yanlış	Token’ı ve başlık adını kontrol edin
`missing_signature`	401	HMAC modu, imza başlığı yok	Ön ayarınızın beklediği imza başlığını gönderin
`invalid_signature`	401	İmza eşleşmedi	İmza gizli anahtarını ve iletim sırasında gövdenin değiştirilmediğini doğrulayın
`auth_not_configured`	401	Oturum açma modu ayarlandı ancak jeton kaydedilmedi	Webhook'ta bir jeton kaydet
`invalid_json`	400	Veri, geçerli bir JSON değildir	Geçerli bir JSON gönderin ya da gövdenizin gerçekte sahip olduğu Content-Type değerini ayarlayın (form verileri ve XML de okunur)
`invalid_body`	400	Bir form ya da XML gövdesi okunamadı ya da gövde `null` değerindedir	Bir JSON nesnesi veya Content-Type başlığıyla eşleşen bir gövde gönderin
`mapping_field_missing`	400	Yükte eşlenmiş bir alan bulunmuyor	Alanı gönder veya eşleşmesini kaldır
`unexpected_fields`	400	Vardaki bazı alanlar eşleştirilmemiştir	Bunları haritalandırın, kaldırın veya Özel istek gövdesine izin ver seçeneğini etkinleştirin
`ip_not_allowed`	403	Arayanın adresi, webhook’un IP izin listesinde yer almıyor	IP izin listeleri bölümüne bakınız
`invalid_proxy_signature`	401	Uygulamanın proxy adresi, mağazanızın etki alanı üzerinden değil, doğrudan çağrıldı	Webhook URL’sini tam olarak uygulamanın gösterdiği şekilde kullanın - bkz. CORS, uygulama proxy URL’si ve tarayıcı çağrıları
`payload_too_large`	413	50 KB'yi aşan Shopify Flow veri yükü	Daha az veri gönderin veya veri isteği anahtarlarını kapatın
`quota_exceeded`	400	Plan sınırına ulaşıldı	Planlar ve kullanım bölümüne bakınız

Canlı İstek Denetleyicisi

Düzenleyicide bir webhook açıkken, denetleyici gelen istekleri gerçek zamanlı olarak gösterir - reddedilenler de dahil olmak üzere, bunların nedenleri de belirtilir. Bu, bir göndericiyi hata ayıklamanın açık ara en hızlı yoludur: bir istek gönderin ve isteklerin ulaşmasını izleyin.

Burada, "yinelenen" olarak etiketlenmiş ve gizlenmiş yinelenen öğeler de görünür - bkz. Yinelenen teslimat koruması.

Tekrar Oynat

Geçmişteki herhangi bir çağrı, ayrıntı sayfasından yeniden oynatılabilir. Yeniden oynatma işlemi, aynı yükü aynı webhook üzerinden yeniden gönderir.

Şu iki konuda çok faydalıdır:

Shopify Flow iş akışını oluşturma. Webhook Tetikleyicisi’nde olayları kaydedin, ardından gerçek bir Shopify Flow'un gerçek alan adlarınızı öğrenmesi için bu çağrıyı yapın.
Bozuk bir iş akışından kurtarma. İş akışını düzeltin, ardından çalışmış olan olayları yeniden çalıştırın oysa bu yanlıştı.

Tekrarlar, geçmişte bu şekilde işaretlenir ve paket kotanızdan düşülmez.

Sık karşılaşılan durumlar

Çağrılar geliyor ancak iş akışı çalışmıyor. Sorun neredeyse her zaman Webhook Kimliği koşuluyla ilgili. Bir Webhook Tetikleyicisi iş akışı, sahip olduğunuz her webhook’tan olaylar alır; bu nedenle, belirli bir webhook kimliğiyle eşleşen bir koşula ihtiyaç duyar - bkz. İlk webhook'unuzu oluşturun.

İş akışı iki kez çalışıyor. Ya iki iş akışı da belirgin koşullar olmaksızın Webhook Tetikleyicisini kullanıyor ya da göndereniniz yeniden deneme yapıyor. Geçmiş, hangisi olduğunu gösterir: iki giriş, iki isteğin geldiği anlamına gelir. Yinelenen teslimat koruması seçeneğini etkinleştirin.

Tarihçede hiçbir şey yok. İstek bize hiç ulaşmadı. URL’yi ve kısa kodu kontrol edin; ayrıca gönderen tarafında TLS veya DNS hatası olup olmadığını da kontrol edin.

Durum Beklemede olarak kalmış. Teslimat, geri çekilme süresiyle yeniden denenir; kalıcı bir hata durumunda durum, nedeni belirtilerek “Başarısız” olarak güncellenir. Durumun alışılmadık derecede uzun süre “Beklemede” olarak kalması durumunda, status.codecreationlabs.cloud adresini kontrol edin.