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

Olay Akışı

GET /api/v1/events, saklanan olayları artan sequence sırasıyla döndürür. X-API-Key ile regulations:read izni gerekir; JWT çağrıları aynı kurum bağlamı ve feed:read sayfa iznine tabidir. GLOBAL kayıtlar kurumun plan kaynak politikasına, ORG kayıtlar yalnız çağıran kuruma göre süzülür. Yalnız livemode: true kayıtlar döner.

Olay birimi mevzuat başınadır: iki farklı mevzuat iki ayrı olay üretir. Yalnız canlı taramayla gelen yeni yayın (LIVE_SCRAPE) ve bildirimleri bastırılmamış kayıt olay üretir. Reindex, taxonomy repair, restore, arşiv ve geçmiş tamir işlemleri olay üretmez. Aynı yayının yeniden işlenmesi ikinci olay veya ikinci webhook teslimi oluşturmaz. Akıştaki event_id, webhook payload’ındaki event_id ile aynıdır; akışın payload nesnesi webhook’un data nesnesiyle birebir eşleşir. Olay sınıflandırma tamamlandıktan sonra kaydedilir. Önceki webhook teslimleri bu deftere geri doldurulmaz; geçmiş veriyi mevzuat değişikliklerinden alın.

ParametreAçıklama
afterÖnceki yanıttaki opak next_cursor; ilk istekte gönderilmez.
typesVirgülle ayrılmış webhook olay türleri; örneğin NEW_REGULATION,REGULATION_UPDATED.
limit1–100; varsayılan 20.
GET /api/v1/events?types=NEW_REGULATION&limit=100 X-API-Key: <api-key>

Yanıt zarfı {success,data} biçimindedir. data içinde items, next_cursor ve has_more bulunur. Her öğe sequence (ondalık metin), event_id, event_type, scope, occurred_at, livemode ve payload taşır. occurred_at, olayın platformda kaydedildiği andır; resmi yayın tarihi değildir. 30 günlük okuma ve saklama süresi bu kayıt anından başlar. Yayın payload’ı sourceType, sourceCode, regulationIds, classificationStatus, docsFound ve docsNew alanlarını taşır. classificationStatus değeri COMPLETED, iki sayaç da 1 olur; kişisel alanlar ve sırlar döndürülmez.

{ "success": true, "data": { "items": [{ "sequence": "42", "event_id": "evt_7f39a2c81b9045e6", "event_type": "NEW_REGULATION", "scope": "GLOBAL", "occurred_at": "2026-10-29T12:00:00.000Z", "livemode": true, "payload": { "sourceType": "GIB", "sourceCode": "GIB", "regulationIds": ["reg_01"], "classificationStatus": "COMPLETED", "docsFound": 1, "docsNew": 1 } }], "next_cursor": "opaque-cursor", "has_more": false } }

has_more: true ise aynı types ile after=<next_cursor> gönderin. Son sayfanın imlecini saklayabilirsiniz: daha sonra aynı imleçle yeni kayıtları sorgulayın. Boş sonuç mevcut imleci korur. Tür sırası ve yinelenen türler normalleştirilir; tür kümesini veya kurumu değiştirmek imleci geçersiz kılar.

Saklama 30 gündür. İmleç satırı 30 günden eskiyse veya silinmişse 410 ve cursor_expired kodu ile /api/v1/changes ile yeniden doldurun yönergesi alınır. Bozuk, imzasız veya farklı filtreye ait imleç 400 döndürür. Hız/kota aşımında 429 ve Retry-After, hız sınırlama servisi kullanılamıyorsa 503 döner. Diğer ortak hatalar için API kurallarına bakın.

Belge Bağlantıları

app_url, /regulation/<id> uygulama detayını açan kanonik URL’dir. Sorgu, fragment, oturum, token, kullanıcı veya kurum kimliği taşımaz. Oturum yoksa mevcut OTP giriş akışı aynı belgeye dönüş adresini korur; tek tıkla giriş bağlantısı değildir. Belge erişimi ve kurum notlarının görünürlüğü mevcut yetki kontrollerinden geçer.

public_url, yalnız kamu arşivine uygun belgede yapılandırılmış kamu kökü ve kanonik /mevzuat/... yolunu içerir. Özel, kuruma ait, arşivlenmiş, henüz yayımlanmamış veya desteklenmeyen kaynak belgelerinde null olur. Kamu kökü yapılandırılmamışsa da null döner. Alanlar additive olup eski alanları korur.

Yeni NEW_REGULATION olaylarında payload / webhook data alanları app_url ve public_url içerir; regulationIds dizisi tek belge kimliğini korur. ACTION_DEADLINE_APPROACHING ve REGULATION_UPDATED webhook data alanı da ilgili belge bağlantılarını taşır. Olay zarfı ve event_version: 1 değişmez. Önceden kaydedilmiş olaylarda bu alanlar bulunmayabilir; tüketiciler bunu desteklemelidir. Diğer olay türlerinde bağlantı alanlarının varlığını varsaymayın.