İzleme Güncelleme Sıklığını Yapılandırmanın 7 Yolu: Daha Güncel Veriler, Daha Az API İsteği
İzleme güncelleme sıklığını; bir güncellik hedefi belirleyerek, gönderi durumuna göre yoklama sıklığını değiştirerek, desteklenen yerlerde webhook kullanarak, kaçırılan güncellemeleri uzlaştırarak, paylaşılan sonuçları önbelleğe alarak, planlanmış işleri toplu hâle getirerek ve hatalar veya hız sınırları sırasında geri çekilme uygulayarak yapılandırın. Geliştiriciler ve operasyon ekipleri için amaç mümkün olan en kısa aralık değildir: amaç, değişmemiş verileri tekrar tekrar istemeden yararlı gönderi değişikliklerini sistemlerinize aktarmaktır.
Bu kontroller genellikle izleme sağlayıcınızı bir sipariş yönetim sistemine, destek platformuna veya müşteriye yönelik izleme sayfasına bağlayan uygulamada bulunur. Bazı sağlayıcılar kendi yenileme kontrollerini de sunar. Bu iki katmanı ayrı tutun: uygulamanızın istek zamanlamasını değiştirmek, sağlayıcının taşıyıcıyı ne sıklıkla kontrol ettiğini zorunlu olarak değiştirmez.
Önce, hangi güncelleme sıklığını kontrol edebileceğinizi belirleyin
Bir gönderi güncellemesi, müşteri onu görmeden önce birkaç aşamadan geçer. Taşıyıcı bir olayı kaydeder, bir izleme hizmeti bunu alır, uygulamanız bilgiyi alır veya getirir ve arayüzünüz görüntüler. Herhangi bir aşamadaki gecikmeler, izlemenin güncelliğini yitirmiş görünmesine neden olabilir.
- Taşıyıcı olayı kullanılabilirliği: Taşıyıcının bir taramayı veya durum değişikliğini kaydedip yayımladığı zaman.
- Sağlayıcı yenileme sıklığı: Bir izleme hizmetinin taşıyıcı bilgilerini kontrol ettiği veya aldığı zaman.
- Uygulama alma sıklığı: Sisteminizin bilgi istediği veya gelen bildirimleri işlediği zaman.
- Görüntü yenileme sıklığı: Web sitenizin, uygulamanızın veya destek aracınızın yerel görünümünü yenilediği zaman.
Bir sağlayıcıyı daha sık yoklamak üçüncü gecikmeyi azaltabilir. Belgelenmiş bir uç nokta bu işlemi açıkça gerçekleştirmediği sürece daha yeni bir taşıyıcı taramasını garanti edemez veya yukarı akıştaki yenilemeyi zorlayamaz. Bir zamanlamayı değiştirmeden önce, API isteğinin kayıtlı izleme verilerini mi okuduğunu, yenilemeyi mi başlattığını veya başka bir işlem mi yaptığını belirleyin.
Bir 17TRACK entegrasyonu için Tracking API genel bakışı ve resmî API belgeleri ile başlayın. Güncelleme teslimi, istek sınırları ve yenileme kontrolleri dâhil olmak üzere kullanmayı planladığınız işlemlerin davranışını doğrulayın. Aşağıdaki zamanlama modellerinin uygulama tarafı önerileri olduğunu, her aralığın yapılandırılabilir bir 17TRACK ayarı olduğu iddiasını taşımadığını unutmayın.
1. Bir aralık seçmeden önce güncellik hedefi belirleyin
Her iş akışının yeni kullanılabilir bir olay hakkında ne kadar hızlı bilgi sahibi olması gerektiğini tanımlayın. Bir teslimat istisnası kuyruğu, geçmiş gönderi panosundan daha sıkı bir hedefi haklı çıkarabilir. Her ikisine de aynı yoklama aralığını vermek istekleri boşa harcar veya daha acil iş akışını yetersiz bırakır.
İki ölçümü birbirinden ayırın: son başarılı alma işleminden bu yana geçen süre ve en son gönderi olayının yaşı. Başarılı bir istek, hiçbir şey değişmediği için eski bir olay döndürebilir. Bu, yakın zamanda veri almamış başarısız bir entegrasyondan farklıdır.
Aralıkları kodunuzun her yerine gömmek yerine küçük bir yapılandırma politikası kullanın:
- Güncellik amacı: Sağlayıcıdaki kullanılabilirlik ile uygulamaya alma arasındaki kabul edilebilir gecikme.
- Normal yoklama aralığı: Uygun gönderiler için varsayılan aralık.
- Maksimum uzlaştırma aralığı: Bir gönderinin başarılı doğrulama olmadan kalabileceği en uzun süre.
- İstek bütçesi: Yeniden denemeler, uzlaştırma ve diğer API işlemleri hesaba katıldıktan sonra kullanılabilir kapasite.
Planlama örneği olarak, 12.000 gönderiyi her saat ayrı ayrı kontrol etmek, yeniden denemelerden önce günde 288.000 planlanmış arama isteği oluşturur. Bunları dört saatte bir kontrol etmek 72.000 istek oluşturur. Bunlar örnek hesaplamalardır; sağlayıcı sınırları veya önerilen aralıklar değildir. Toplu işlemler ve push teslimi hesaplamayı değiştirir.
İş akışının güncellik amacını karşılayan en uzun aralığı seçin, ardından yukarı akış verilerinin bu aralığı yararlı kılacak kadar güncel olup olmadığını test edin.
2. Gönderinin durumu değiştikçe aralığı değiştirin
Tek bir zamanlama, gönderilerin nasıl davrandığını göz ardı eder. İlk taramasını bekleyen bir paket, uzun bir taşıma aşamasında ilerleyen bir paket ve teslimata yaklaşan bir paket aynı düzeyde ilgi gerektirmeyebilir.
| Gönderi durumu | Önerilen zamanlama yaklaşımı | Güvence |
|---|---|---|
| İlk taşıyıcı bilgisi bekleniyor | Sınırlandırılmış kontroller kullanın, ardından değişiklik yoksa aralığı uzatın. | Yalnızca taramaların eksik olmasını gönderi arızasının kanıtı saymayın. |
| Normal şekilde ilerliyor | İlgili hizmet veya rota için temel aralığı kullanın. | Maksimum uzlaştırma aralığını koruyun. |
| Teslimata yaklaşıyor | Zamanında güncellemeler gerçek bir eylemi destekliyorsa daha kısa aralıkları değerlendirin. | Ek isteklerin yeni bilgi döndürüp döndürmediğini ölçün. |
| İstisna veya uzun süreli hareketsizlik | İncelemeye öncelik verin ve sınırlandırılmış bir izleme zamanlaması kullanın. | Daha hızlı yoklama temel istisnayı çözmez. |
| Teslim edildi veya başka şekilde tamamlandı | Kapanış kontrollerinizden sonra rutin yoklamadan çıkarın. | Düzeltmelere ve meşru yeniden açılmalara izin verin. |
Sağlayıcı durumlarını iç yaşam döngünüze açıkça eşleyin. İade edilen gönderi, başarısız teslimat denemesi ve tamamlanmış teslimatın tümünün izlemeyi durdurması gerektiğini varsaymayın. Bunlar farklı operasyonel kararlar gerektirebilir.
Her gönderi için bir sonraki uygun kontrol zaman damgasını saklayın ve anlamlı olaylar geldiğinde bunu yeniden hesaplayın. Bu, zamanlamayı denetlenebilir hâle getirir ve her kaydı aynı şekilde ele alan bir zamanlayıcıya güvenmeyi önler.
3. Sağlayıcı destekliyorsa değişiklikler için webhook kullanın
Yoklama herhangi bir şeyin değişip değişmediğini sorar. Webhook, bir güncelleme kullanılabilir olduğunda sağlayıcının uygulamanıza bildirim göndermesini sağlar. Gerekli olaylar ve teslim davranışı destekleniyorsa, etkin her gönderiyi tekrar tekrar sorgulamak yerine push teslimini birincil veri alma yolu olarak kullanın.
Webhook'lar yukarı akış gecikmelerini ortadan kaldırmaz. Ayrıca teslimat işleme gereksinimleri getirir. Uygulamadan önce sağlayıcının belgelenmiş kimlik doğrulama mekanizmasını, onay kurallarını, yeniden deneme davranışını ve olay tanımlayıcılarını doğrulayın.
- Gelen isteklerin kimliğini belgelenmiş mekanizmayı kullanarak doğrulayın.
- Başarılı alımı onaylamadan önce geçerli bir bildirimi kalıcı olarak saklayın veya kuyruğa alın.
- Tekrarlanan teslimatın mükerrer müşteri mesajlarını tetiklememesi için bildirimleri idempotent biçimde işleyin.
- Daha eski bilgilerle daha yeni durumu ezmeden gecikmiş ve sıra dışı olayları işleyin.
- İşleme hatalarını ve kuyruğa alınmış bildirimlerin yaşını izleyin.
Sağlayıcı açıkça garanti etmedikçe webhook teslimatının tam olarak bir kez gerçekleştiğini veya her zaman kronolojik sırada olduğunu varsaymayın. Geç gelen bilgilerin körü körüne uygulanmak yerine değerlendirilebilmesi için gönderinin olay geçmişini mevcut normalleştirilmiş durumundan ayrı tutun.
4. İkinci bir tam yoklama döngüsü yerine hedefli uzlaştırma ekleyin
Webhook tabanlı bir entegrasyonun yine de bir kurtarma yoluna ihtiyacı vardır. Uç noktanız kullanılamıyor olabilir, bir çalışan alımdan sonra başarısız olabilir veya dahili bir eşleme hatası güncellemenin sipariş kaydına ulaşmasını engelleyebilir.
Uzlaştırma, saklanan durumunuzun sağlayıcının durumuyla uyuşup uyuşmadığını kontrol eder. Tüm gönderi kümesinde sık yoklamayı yeniden oluşturmak yerine doğrulanması gereken kayıtlara odaklanmalıdır.
Yararlı uzlaştırma adayları arasında bildirim işleme hatası yaşayan gönderiler, maksimum doğrulama aralığını aşan kayıtlar ve bilinen bir kesintiden etkilenen gönderiler bulunur. Tek başına eski bir taşıyıcı olayı, kaçırılmış bir güncellemenin kanıtı değildir.
Bir kesintiden sonra etkilenen kayıtları kuyruğa alın ve kontrollü bir istek bütçesi içinde tüketin. Çakışan kurtarma işlerini tekilleştirin ve başarılı bir güncelleme tutarsızlığı zaten çözdüğünde gereksiz işleri iptal edin. Her etkin gönderi için aynı anda bir istek başlatmaktan kaçının.
Son başarılı doğrulama zaman damgasını en son olay zaman damgasından ayrı izleyin. Aksi takdirde, yakın zamanda taraması olmayan bir paket, sisteminiz sağlayıcının yeni bilgisi olmadığını az önce doğrulamış olsa bile tekrar tekrar uzlaştırma için uygun hâle gelebilir.
5. İzleme verilerini önbelleğe alın ve istekleri tüketiciler arasında paylaşın
Bir izleme sayfası, destek panosu, bildirim çalışanı ve sipariş sistemi aynı gönderiyi isteyebilir. Her tüketicinin izleme sağlayıcısını bağımsız olarak sorgulamasına izin vermek yerine ortak bir uygulama kaydı sağlayın.
En son bilinen gönderi durumunu, alma zamanı ve ilgili olay zaman damgalarıyla birlikte yerel olarak saklayın. Zamanlayıcınızın veya webhook işleyicinizin bu kaydı güncellemesine izin verin. Bir müşterinin sayfayı yenilemesi otomatik olarak başka bir yukarı akış isteğini zorlamamalıdır.
Önbelleklemenin yanı sıra istek birleştirme de kullanın: birkaç tüketici aynı eski kaydı aynı anda isterse tek bir yenileme işlemine izin verin ve diğerlerinin sonucunu kullanmasına veya beklemesine olanak tanıyın. Verilerin hesap sınırlarını aşmaması için önbellek anahtarlarını ve erişim kontrollerini doğru kapsamlandırın.
Bir uç nokta ETag veya Last-Modified gibi HTTP doğrulayıcılarını destekliyorsa koşullu istekler yanıt gövdesi aktarımını azaltabilir. Ancak koşullu istek hâlâ bir istektir ve sağlayıcının kotasına dâhil olabilir. HTTP önbellekleme semantiği RFC 9111 içinde tanımlanmıştır; belirli bir izleme uç noktası için destek ayrıca kontrol edilmelidir.
Arayüzde güncelliği anlaşılır hâle getirin. “Son kontrol” alma işlemini, “En son gönderi olayı” ise taşıyıcı olayını açıklamalıdır. Tek bir zaman damgasını her ikisini temsil ediyormuş gibi göstermek müşterileri yanıltabilir.
6. Uygun aramaları toplu hâle getirin ve istekleri zamana yayın
İlgili arama uç noktası bir istek başına birden fazla izleme kaydını desteklediğinde toplu işlemler HTTP isteklerinin sayısını azaltabilir. İhtiyacınız olan işlemin toplu işlemi desteklediğini doğrulayın: toplu kayıt, otomatik olarak toplu alma anlamına gelmez.
Ayrıca taşıma verimliliği ile ücretlendirmeyi birbirinden ayırın. Birkaç kayıt içeren tek bir HTTP isteği, sağlayıcının kurallarına bağlı olarak yine de birkaç kota birimi veya ücretlendirilebilir arama tüketebilir.
Uygulamalı bir zamanlayıcı şunları yapmalıdır:
- Bir sonraki uygun kontrol zamanı gelmiş kayıtları seçmek.
- Tamamlanmış, duraklatılmış veya zaten kuyruğa alınmış kayıtları dışlamak.
- Uygun kayıtları belgelenmiş uç nokta ve yük sınırları içinde gruplamak.
- İşleri ortak bir hız sınırlayıcı üzerinden göndermek.
- Her öğenin sonucunu kaydetmek ve uygun olduğunda yalnızca başarısız veya çözümlenmemiş öğeleri yeniden denemek.
Tüm işleri saat başında çalıştırmak yerine zamanlama penceresine yayın. Eşzamanlı ani yükleri azaltmak için jitter olarak adlandırılan sınırlı bir rastgele ofset ekleyin. Bu ofseti her iş akışının güncellik amacına uyacak kadar küçük tutun.
Bir toplu işlemi doldurmayı beklemek acil bir güncellemeyi geciktirecekse toplu işlem daha az yararlıdır. Zamana duyarlı işlerin tam bir toplu işlem olmadan ilerlemesine izin verin; ancak bunları aynı genel hız bütçesi içinde tutun.
7. Hız sınırlarına, hatalara ve düşük değerli kontrollere uyum sağlayın
Normal güncelleme aralığınız hata yeniden deneme aralığınız da olmamalıdır. Kullanılamayan bir uç nokta, başarısızlıkların üzerine eklenmiş başka bir tam planlanmış istek dalgası değil, kontrollü yeniden denemeler gerektirir.
HTTP 429, “Too Many Requests” anlamına gelir ve yanıt, RFC 6585'te açıklandığı üzere bir Retry-After alanı içerebilir. Alanın HTTP semantiği RFC 9110'da tanımlanır. Geçerli bir Retry-After değeri sağlandığında geçerli sağlayıcı talimatlarını ve bu değeri izleyin. Aksi takdirde yeniden denenebilir hatalar için jitter içeren sınırlı üstel geri çekilme kullanın.
Kimlik doğrulama hatalarını veya geçersiz izleme girdilerini süresiz olarak yeniden denemeyin. Bunları düzeltmeye yönlendirin. Sunucu tarafındaki durumu değiştiren işlemlerde, belirsiz bir zaman aşımından sonra isteği otomatik olarak tekrarlamadan önce yeniden deneme güvenliğini doğrulayın.
Normal yoklamayı ayrı şekilde uyarlayın. Art arda yapılan başarılı kontroller yeni bilgi döndürmüyorsa gönderinin güncellik sınırları içinde aralığı uzatmayı değerlendirin. Anlamlı bir olay paketi zamana daha duyarlı bir aşamaya taşıdığında aralığı yeniden kısaltın.
İlgili kotayı paylaşan tüm çalışanlar arasında hız sınırlaması uygulayın. Bağımsız çalışan sınırlarının her biri uyumlu görünürken birleşik trafik hesap düzeyindeki izni aşabilir.
Güncelliği ve verimliliği birlikte doğrulayın
Politikayı geniş ölçekte uygulamadan önce kontrollü bir gönderi grubu üzerinde test edin. Gönderi karışımındaki değişikliğin zamanlama iyileştirmesi gibi görünmemesi için benzer taşıyıcı, rota ve yaşam döngüsü özelliklerine sahip iş akışlarını karşılaştırın.
- Yararlı güncelleme getirisi: Anlamlı bilgi ekleyen başarılı kontrollerin oranı.
- Doğrulama yaşı: Son başarılı sağlayıcı durumu kontrolünden bu yana geçen süre.
- Alma gecikmesi: Kullanılabilirlik zamanının gözlemlenebildiği durumlarda sağlayıcıdaki kullanılabilirlikten uygulamanın alımına kadar geçen süre.
- İstek baskısı: İstek hacmi, hız sınırı yanıtları, yeniden denemeler ve kuyruk derinliği.
- Kurtarma kalitesi: Uzlaştırma yoluyla kurtarılan kaçırılmış değişiklikler ve hataları temizlemek için geçen süre.
Taşıyıcı olayından alıma kadar geçen süreyi saf entegrasyon gecikmesi olarak etiketlemeyin. Bu süre, uygulamanızın doğrudan kontrol edemediği yukarı akış yayınlama ve toplama gecikmelerini içerebilir. Başarılı bir politika, operasyonel açıdan önemli değişiklikleri tanımlanan güncellik hedefleri içinde tutarken gereksiz almayı azaltır.
SSS
Gönderi takibi için en iyi yoklama aralığı nedir?
Evrensel bir aralık yoktur. Aralığı iş akışının güncellik hedefinden, yukarı akış güncelleme davranışından, API sınırlarından ve istek bütçesinden seçin. Belgelenmiş bir temel değerle başlayın, başarılı kontrollerin değerini ölçün ve her gönderiyi daha hızlı yoklamak yerine yaşam döngüsü durumuna göre ayarlayın.
Bir izleme sayfasını yenilemek yeni bir taşıyıcı kontrolünü zorlar mı?
Her zaman değil. Sayfa, uygulama önbelleğinizi veya sağlayıcının kayıtlı izleme verilerini okuyabilir. Tarayıcı yenilemesi, API araması ve yukarı akış taşıyıcı yenilemesi farklı işlemlerdir. Yalnızca belgelenmiş davranış bu iddiayı destekliyorsa bir yenilemeyi canlı olarak tanımlayın.
Webhook'lar yoklamanın yerini tamamen alabilir mi?
Sağlayıcı gerekli güncellemeleri desteklediğinde rutin yoklamanın büyük bölümünün yerini alabilirler. Hatalar ve belirsiz durumlar için sınırlandırılmış bir uzlaştırma sürecini koruyun. Ne kadar kontrolün gerekli olduğu teslimat garantilerine, kurtarma seçeneklerine ve kaçırılan bir güncellemenin sonuçlarına bağlıdır.
Teslimattan sonra izleme istekleri ne zaman durdurulmalıdır?
Kapanış kontrollerinizi tamamladıktan sonra teslim edilmiş gönderileri rutin etkin yoklamadan çıkarın. İş akışınız ve sağlayıcı davranışınız sınırlı bir doğrulama dönemini haklı çıkarıyor mu karar verin. Her tamamlanmış gönderiyi süresiz bir zamanlamada tutmadan düzeltmeleri işleme yeteneğini koruyun.
Daha az HTTP isteği API ücretlerini her zaman azaltır mı?
Hayır. Ücretlendirme HTTP istek sayısı yerine gönderilere, izleme kayıtlarına, işlemlere veya başka bir sözleşmesel birime bağlı olabilir. Toplu işlem, önbellekleme veya webhook kullanımından finansal tasarruf beklemeden önce geçerli ölçüm kurallarını doğrulayın.
Kaynaklar
- 17TRACK Tracking API genel bakışı — izleme entegrasyonunu değerlendirmek için resmî başlangıç noktası.
- 17TRACK API belgeleri — uygulama tarafı zamanlamasını yapılandırmadan önce desteklenen işlemleri ve entegrasyon gereksinimlerini doğrulamak için başvuru kaynağı.
- RFC 9110: HTTP Semantiği — HTTP yöntem semantiği, koşullu istekler ve Retry-After.
- RFC 9111: HTTP Önbellekleme — önbellek davranışı ve yanıt doğrulama.
- RFC 6585: Ek HTTP Durum Kodları — 429 Too Many Requests yanıtının tanımı.


