Mevzuat Değişiklikleri API
GET /api/v1/changes
Mevzuat özetlerini ERP, GRC ve uyum otomasyonlarına aktarır. Bu yol kimlik
doğrulama gerektirir; kimliksiz arşiv uç noktası değildir. Tam mevzuat metni
döndürülmez. verificationStatus=PASSED, isPrivate=false,
ownerOrganizationId=null, qualityGateStatus=PASSED ve
qualityPublishEligible=true koşulları uygulanır.
Sonuçlar organizasyonun kaynak erişim politikasına göre daraltılır.
Organizasyonun primarySectors tercihi doluysa, bu sektörlerden en az biriyle
eşleşen kayıtlar gelir. Dolayısıyla farklı organizasyonlar aynı sorguda aynı
listeyi almak zorunda değildir. Sıralama publishedAt azalandır.
Kimlik Doğrulama ve Yetki
| Alan | Kural |
|---|---|
| API anahtarı | x-api-key; regulations:read izni gerekir |
| JWT | Authorization: Bearer <JWT>; organizasyon oturumu gerekir |
| Plan ve kota | Anahtar için publicApi özelliği ve desteklenen plan gerekir; varsayılan plan kodları PROFESSIONAL, COMMERCIAL, ENTERPRISE olur. JWT ve anahtar çağrıları genel API kotasını tüketir |
| Organizasyon | Sunucuda kimlik doğrulama bağlamından çözülür; sorgudan alınmaz |
| OpenAPI | Yol /api/docs-json izin listesinde bulunur |
Bu controller JWT için ayrıca bir rol veya sayfa izni tanımlamaz. API anahtarı izin kontrolü JWT çağrısına aynı biçimde uygulanmaz.
Sorgu Parametreleri
Bütün parametreler isteğe bağlıdır. Tanımlanmamış alanlar 400 döner.
| Parametre | Tip ve doğrulama | Varsayılan / anlam |
|---|---|---|
cursor | Metin, en fazla 2048 karakter | İlk imleç sayfası için boş metin; sonrakiler için data.meta.nextCursor. page ile birlikte 400 |
page | Tam sayı, en az 1 | 1 |
limit | Tam sayı, 1–100 | 20 |
source | SourceType enum değeri | Kaynak türü filtresi |
sourceCode | Metin, en fazla 64 karakter | Kayıttaki kaynak koduyla eşitlik filtresi |
impactLevel | KRITIK, YUKSEK, ORTA, BILGILENDIRME | Etki filtresi |
dateFrom | ISO 8601 tarih metni | publishedAt için dahil alt sınır |
dateTo | ISO 8601 tarih metni | publishedAt için dahil üst sınır |
source aşağıdaki değerleri kabul eder:
RESMI_GAZETE, BDDK, TCMB, SPK, SEDDK, MASAK, HMB, MEVZUAT_GOV,
GIB, KIK_EKAP, KVKK, CALISMA_SGK, TICARET, CUSTOMCUSTOM DTO tarafından kabul edilir; özel veya organizasyona ait kayıtları
görünür kılmaz. sourceCode ayrı bir metin alanıdır; enum doğrulaması yoktur.
İki kaynak parametresi birlikte verilirse iki koşul da uygulanır.
Tarih sınırları verilmezse o yönde tarih filtresi yoktur. Yalnız tarih içeren
dateTo=2026-10-24, günün sonuna genişletilmez; zaman damgası gerekiyorsa
saat ve saat dilimi açıkça gönderilir. Aralık sırası ayrıca doğrulanmaz.
sourceCategory, sourceCategories, sourceSubcategory ve
legalDocumentClass bu uç noktada desteklenmez. İlgili filtreler
Herkese Açık Mevzuat Arşivi sayfasındadır.
Yanıt
Başarı durumu 200; sayfalama alanları doğrudan data içindedir:
{
"success": true,
"data": {
"items": [],
"total": 0,
"page": 1,
"limit": 20,
"totalPages": 0
}
}data.items[] alanı | Tip / anlam |
|---|---|
id, title | Metin |
sourceType | Kaynak türü |
sourceCode | Kaynak kodu veya null |
publishedAt | ISO 8601 tarih-saat |
complianceDeadline | ISO 8601 tarih-saat veya null |
impactLevel | Yukarıdaki etki değerlerinden biri |
sectors, topics | Metin dizileri |
summary | Özet metni veya null |
İç kalite alanları yanıttan çıkarılır. Sonuç yokken totalPages=0, diğer
hallerde ceil(total / limit) olur.
İmleçle Sayfalama
Ofset davranışı korunur: cursor gönderilmediğinde yanıt alanları ve yalnız
publishedAt azalan sırası aynıdır. İmleç akışına ?cursor=&limit=100 ile
başlanır. Sonraki istekte data.meta.nextCursor değeri cursor olarak gönderilir.
İmleç modunda sıra publishedAt ve eşit tarihte id azalandır. Araya daha yeni
kayıt eklenmesi sonraki sayfalarda ofset kaymasına yol açmaz.
data içindeki mevcut alanlara meta: {nextCursor, hasMore} eklenir. Son sayfada
nextCursor=null, hasMore=false olur. Bu akış bir veritabanı snapshot’ı değildir;
mevcut kaydın yayın tarihi veya görünürlüğü değişirse sonuç da değişebilir.
İmleç kimliği doğrulanmış organizasyona ve source, sourceCode, impactLevel,
dateFrom, dateTo filtrelerine bağlıdır. Filtreyi veya organizasyonu değiştirmek,
imzayı bozmak ya da cursor ile page göndermek 400 döndürür. limit bağa dahil
değildir; 1–100 arasında değiştirilebilir. Token içeriğine uygulama mantığı bağlamayın.
const firstUrl = new URL('/api/v1/changes', 'https://api.mevzuatradar.com');
firstUrl.searchParams.set('cursor', '');
firstUrl.searchParams.set('limit', '100');
const first = await fetch(firstUrl, { headers }).then((r) => r.json());
if (first.data.meta.hasMore) {
firstUrl.searchParams.set('cursor', first.data.meta.nextCursor);
const second = await fetch(firstUrl, { headers }).then((r) => r.json());
}Çalıştırılabilir JS, Python ve shell örnekleri MEVZUATRADAR_CURSOR isteğe bağlı
ortam parametresini kabul eder. Bu yalnız örnek istemcisinin ayarıdır.
MEVZUATRADAR_CURSOR='' node apps/docs/examples/changes.js ilk sayfayı planlar;
API anahtarı verilmezse ağ isteği atılmaz.
Hata Kodları
| HTTP durumu | Anlam |
|---|---|
400 | Geçersiz enum, tarih, sorgu alanı veya sayfalama |
401 | JWT/API anahtarı eksik veya geçersiz |
402 | Genel API kotası çözülürken abonelik bağlamı bulunamıyor |
403 | Anahtar/IP izni, plan özelliği veya kullanım kotası yetersiz |
429 | İstek hızı aşıldı; mevcutsa Retry-After süresine uyulur |
503 | API anahtarının hız sınırı denetimi kullanılamıyor |
Hatalar application/problem+json türünde döner. Ortak alanlar
Ortak API Kuralları sayfasındadır.
Örnekler
curl --fail-with-body --get 'https://api.mevzuatradar.com/api/v1/changes' \
--data-urlencode 'source=BDDK' \
--data-urlencode 'impactLevel=YUKSEK' \
--data-urlencode 'limit=20' \
-H "x-api-key: $MEVZUATRADAR_API_KEY"const response = await fetch(
'https://api.mevzuatradar.com/api/v1/changes?source=BDDK&limit=20',
{ headers: { 'x-api-key': process.env.MEVZUATRADAR_API_KEY } },
);
if (!response.ok) throw new Error(`API: ${response.status}`);
const { data } = await response.json();
console.log(data.items);Vergi konusu ve yürürlük tarihi
Her mevzuat satırı effectiveDate ve taxTags alanlarını ek olarak döndürür.
effectiveDate, resmi kaynak metninde tek ve açık bir yürürlük tarihi varsa ISO 8601
zamanıdır; bulunamazsa null kalır. Yayım günü, son başvuru günü ve göreli yürürlük
ifadeleri otomatik tarih sayılmaz. taxTags kontrollü konu etiketlerinden oluşur:
KDV, VUK, GV, KV, SGK, E_BELGE, OTV, DAMGA, HARC.
Eşleşmeyen ve henüz doldurulmayan kayıtlarda [] döner. SGK etiketi prim,
sigortalı bildirimi, işveren beyanı ve prim teşviki konularını kapsar; bireysel aylık
ve GSS geri ödeme duyuruları bu nedenle SGK etiketi almaz. Bu metadata hukuki görüş
veya kapsam garantisi değildir. Sayfa ve cursor biçimleri aynı alanları taşır.
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.