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

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

AlanKural
API anahtarıx-api-key; regulations:read izni gerekir
JWTAuthorization: Bearer <JWT>; organizasyon oturumu gerekir
Plan ve kotaAnahtar 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
OrganizasyonSunucuda kimlik doğrulama bağlamından çözülür; sorgudan alınmaz
OpenAPIYol /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.

ParametreTip ve doğrulamaVarsayılan / anlam
cursorMetin, en fazla 2048 karakterİlk imleç sayfası için boş metin; sonrakiler için data.meta.nextCursor. page ile birlikte 400
pageTam sayı, en az 11
limitTam sayı, 1–10020
sourceSourceType enum değeriKaynak türü filtresi
sourceCodeMetin, en fazla 64 karakterKayıttaki kaynak koduyla eşitlik filtresi
impactLevelKRITIK, YUKSEK, ORTA, BILGILENDIRMEEtki filtresi
dateFromISO 8601 tarih metnipublishedAt için dahil alt sınır
dateToISO 8601 tarih metnipublishedAt 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, CUSTOM

CUSTOM 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, titleMetin
sourceTypeKaynak türü
sourceCodeKaynak kodu veya null
publishedAtISO 8601 tarih-saat
complianceDeadlineISO 8601 tarih-saat veya null
impactLevelYukarıdaki etki değerlerinden biri
sectors, topicsMetin 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 durumuAnlam
400Geçersiz enum, tarih, sorgu alanı veya sayfalama
401JWT/API anahtarı eksik veya geçersiz
402Genel API kotası çözülürken abonelik bağlamı bulunamıyor
403Anahtar/IP izni, plan özelliği veya kullanım kotası yetersiz
429İstek hızı aşıldı; mevcutsa Retry-After süresine uyulur
503API 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.