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.
| Parametre | Açıklama |
|---|---|
after | Önceki yanıttaki opak next_cursor; ilk istekte gönderilmez. |
types | Virgülle ayrılmış webhook olay türleri; örneğin NEW_REGULATION,REGULATION_UPDATED. |
limit | 1–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.