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_idile ayıklayın; aynı olayın yeniden gönderimindeevent_iddeğişmez. - Sırayı teslim zamanına göre kurmayın. Sıra gerekiyorsa
olay akışındaki artan
sequencedeğ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 |
|---|---|
| Professional | 60 dakika |
| Commercial | 10 dakika |
| Enterprise | 1–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_urlvepublic_urlbelge bağlantılarının kuralları Olay Akışı › Belge Bağlantıları bölümündedir.app_urloturum gerektirebilir ve tek tıkla giriş bağlantısı değildir.effectiveDatevetaxTagsalanları Mevzuat Değişiklikleri sayfasında açıklanır; açık yürürlük tarihi yoksaeffectiveDate: null, eşleşme yoksataxTags: []döner.