Ana içeriğe geç
Mevzuat RadarDokümantasyon
Uygulamaya git ↗

Eşitleme ve geri doldurma

Webhook bir şeyin değiştiğini haber verir; güncel kaydın kaynağı API’dir. Önerilen kalıp, teslimi hızlıca kalıcı olarak kabul edip 2xx döndürmek ve ayrıntıyı ayrı bir iş kuyruğunda API’den okumaktır.

İnce olay kalıbı

Webhook data alanını bildirim olarak kullanın. İşleyiciniz gövdedeki kimliklerle (regulationIds, regulationId gibi) kaydı yeniden okur; örneğin mevzuat ayrıntısı için Katalog uçlarını kullanır. Belgelenmemiş alanların varlığını varsaymayın; eski olaylarda sonradan eklenen alanlar bulunmayabilir.

Sırasız olaylar

Teslimlerde sıra garantisi yoktur ve aynı olay birden fazla gelebilir.

  • Tekrarları event_id ile ayıklayın; aynı olayın yeniden gönderiminde event_id değişmez.
  • Sırayı teslim zamanına göre kurmayın. Sıra gerekiyorsa olay akışındaki artan sequence değerini kullanın.
  • Kaydı API’den yeniden okumak, geç gelen eski bir olayın yeni durumu ezmesini önler.

Deneme takviminden sonra geri doldurma

Genel webhook kuyruğu başarısız teslimi 30 saniye, 2 dakika, 10 dakika, 1 saat, 6 saat ve 12 saat sonra yeniden dener; toplam yedi denemedir. Takvim bittikten sonra kaçırılan dönemi olay akışından son saklanan next_cursor ile okuyun. Ayrı bir yeniden gönderim ucu yoktur. Olay akışı 30 günlük kayıt tutar; imleç süresi dolmuşsa 410 cursor_expired alınır ve dönem mevzuat değişikliklerinden yeniden doldurulur. Ayrıntılı teslim kuralları Webhook Akışı sayfasındadır.

Geri doldurma bir kez yapılır

GLOBAL mevzuat olayları uygulama ucuna bir kez teslim edilir; her bağlı kurum için ayrı kopya üretilmez. Geçmiş mevzuat verisini de müşteri başına değil, bir kez doldurun ve kendi deponuzda tüm bağlı kurumlar için paylaşın. Kuruma özel (ORG) veriler ise yalnız ilgili kurumun izniyle ve o kurum için okunur. Her yeni bağlantıda tüm mevzuat geçmişini yeniden çekmek kota ve hız sınırını gereksiz tüketir.

Önerilen yoklama aralığı

Webhook kullanamayan entegrasyonlar için önerilen yoklama aralıkları:

Müşteri planıÖnerilen aralık
Professional60 dakika
Commercial10 dakika
Enterprise1–5 dakika

Bu değerler öneridir; hız sınırı veya kota değildir. Etkin hız sınırları ve aylık kota İstek Limitleri ve Planlar ile Kimlik Doğrulama sayfalarındaki kurallara göre ayrıca uygulanır. Yoklamada son imleci saklayın ve yalnız yeni kayıtları isteyin.

Bağlantılar ve yeni alanlar

  • app_url ve public_url belge bağlantılarının kuralları Olay Akışı › Belge Bağlantıları bölümündedir. app_url oturum gerektirebilir ve tek tıkla giriş bağlantısı değildir.
  • effectiveDate ve taxTags alanları Mevzuat Değişiklikleri sayfasında açıklanır; açık yürürlük tarihi yoksa effectiveDate: null, eşleşme yoksa taxTags: [] döner.