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

Node.js Örnek İstemcisi

Yayımlanma durumu (24 Ekim 2026): npm genel kayıt servisinde  @mevzuat-radar/sdk sorgusu 404 döndürmüştür. npm üzerinden kurulabilen resmî SDK yoktur; bu sayfa doğrudan HTTP kullanan örnek istemci sunar. Depoda packages/sdk-node kaynak paketi bulunması yayımlanmış paket veya kuruma özel kayıt servisi erişimi bulunduğunu kanıtlamaz.

Depodaki Kaynak İstemcinin Metotları

Aşağıdaki metotlar MevzuatRadarClient sınıfının kaynak kodunda bulunur; üstteki yayımlanma durumundan ayrı bir envanterdir. Bu sayfanın doğrudan HTTP örneği bu sınıfı içe aktarmaz. Kaynak: packages/sdk-node/src/client.ts.

MetotHTTP isteğiİstemcinin kimlik modu
getPublicSourceStats()GET /api/v1/public/source-statsKimlik doğrulamasız
listPublicRegulations()GET /api/v1/public/regulationsKimlik doğrulamasız
listChanges()GET /api/v1/changesAPI anahtarı
listDeadlines()GET /api/v1/deadlinesAPI anahtarı
listActions()GET /api/v1/actionsAPI anahtarı
listVerificationReports()GET /api/v1/verification-reportsAPI anahtarı
getVerificationReport()GET /api/v1/verification-reports/:idAPI anahtarı
listBoardReports()GET /api/v1/board-reportsAPI anahtarı
getBoardReport()GET /api/v1/board-reports/:idAPI anahtarı
getEvidencePack()GET /api/v1/evidence-packs/:idAPI anahtarı
listWebhooks()GET /api/v1/webhooksJWT veya Enterprise API anahtarı
createWebhook()POST /api/v1/webhooksJWT veya Enterprise API anahtarı
getWebhook()GET /api/v1/webhooks/:idJWT veya Enterprise API anahtarı
updateWebhook()PUT /api/v1/webhooks/:idJWT veya Enterprise API anahtarı
deleteWebhook()DELETE /api/v1/webhooks/:idJWT veya Enterprise API anahtarı
testWebhook()POST /api/v1/webhooks/:id/testJWT veya Enterprise API anahtarı
rotateWebhookSecret()POST /api/v1/webhooks/:id/rotate-secretJWT veya Enterprise API anahtarı
listWebhookDeliveries()GET /api/v1/webhooks/:id/deliveriesJWT veya Enterprise API anahtarı

Korunan okuma metotları bu istemcide apiKey seçeneğini kullanır; sunucunun JWT de kabul etmesi bu metotların otomatik JWT seçtiği anlamına gelmez. Webhook metotları varsa jwt, yoksa apiKey seçeneğiyle çağrılır ve sunucudaki ADMIN, settings sayfa izni ve Webhook özellik koşullarına tabidir. Oluşturma ve güncelleme metotları gövde, filtrelenebilen liste metotları sorgu seçeneklerini alır; alanlar ve izinler API Referansı ile Webhook Abonelikleri sayfalarında açıklanır. İstemciler başarılı success/data zarfını açarak data döndürür; aşağıdaki doğrudan HTTP örneği ise zarfı kendisi işler.

Kurulum ve Kimlik Doğrulama

Aşağıdaki örnek Node.js 22’nin yerleşik fetch işlevini kullanır; npm paketi kurulmaz. MEVZUATRADAR_API_KEY ortam değişkeni etkin API anahtarını taşır. Anahtarın regulations:read izni ve kurumun Genel API hakkı gerekir. Anahtar tarayıcıya gönderilmez ve kaynak dosyaya yazılmaz.

Mevzuat Değişikliklerini Okuma

Örnek GET https://api.mevzuatradar.com/api/v1/changes çağrısı yapar. Varsayılan page=1, limit=20; izin verilen limit aralığı 1–100’dür. Örnekte beş kayıt istenir. Yanıtın dış zarfı success ve data taşır; liste data.items içindedir.

// changes-client.cjs async function main() { const apiKey = process.env.MEVZUATRADAR_API_KEY; if (!apiKey) throw new Error('MEVZUATRADAR_API_KEY is required'); const url = new URL('https://api.mevzuatradar.com/api/v1/changes'); url.searchParams.set('page', '1'); url.searchParams.set('limit', '5'); url.searchParams.set('sourceCode', 'BDDK'); const response = await fetch(url, { headers: { 'x-api-key': apiKey }, signal: AbortSignal.timeout(20_000), redirect: 'error', }); const payload = await response.json(); if (!response.ok || payload.success !== true) { const retryAfter = response.headers.get('retry-after'); throw new Error( `HTTP ${response.status}: ${payload.detail ?? payload.error ?? 'API error'}; ` + `requestId=${payload.requestId ?? ''}; retryAfter=${retryAfter ?? ''}`, ); } for (const change of payload.data.items) { console.log(change.id, change.title); } console.log('page', payload.data.page, 'totalPages', payload.data.totalPages); } main().catch((error) => { console.error(error instanceof Error ? error.message : String(error)); process.exitCode = 1; });

Kod changes-client.cjs adıyla kaydedilip node changes-client.cjs ile çalıştırılır. Diğer sayfalar page artırılarak okunur. Ek filtreler source, sourceCode, impactLevel, dateFrom, dateTo alanlarıdır; ayrıntılar Mevzuat Değişiklikleri API sayfasındadır.

Depodaki apps/docs/examples/changes.js aynı endpointi limit parametresiyle çağırır ve ayrıştırılmamış JSON zarfını basar. MEVZUATRADAR_LIMIT varsayılanı 5, MEVZUATRADAR_API_BASE_URL varsayılanı https://api.mevzuatradar.com olur. Anahtar yoksa ağ isteği yapmadan dry-run istek taslağı basar; bu çıktı başarılı API yanıtı veya geçerli anahtar değildir.

Webhook İmzası ve Yönetimi

Webhook Akışı sayfasındaki V2 doğrulayıcısı ham Buffer üzerinde HMAC ve 300 saniyelik zaman kontrolü yapar. Aynı işlev depoda apps/docs/examples/webhook-verify-v2.js dosyasındadır; resmî SDK importu kullanmaz. Yardımcı dosya alıcının yanına kopyalandığında kullanım:

const { verifyWebhookV2 } = require('./webhook-verify-v2.js'); const valid = verifyWebhookV2( rawBodyBuffer, request.headers['x-webhook-signature-v2'], process.env.MEVZUATRADAR_WEBHOOK_SECRET, ); if (!valid) { response.writeHead(401).end('invalid signature'); return; } // Persist the verified event and deduplicate before applying side effects.

Bu parça alıcı işleyicisinin içindedir; rawBodyBuffer JSON ayrıştırılmadan önce alınan istek baytlarıdır. Webhook yönetimi ayrı olarak ADMIN JWT, settings sayfa izni ve Webhook özellik hakkı gerektirir; API anahtarıyla çağrılmaz. Yol ve gövde sözleşmeleri Webhook Abonelikleri API sayfasındadır.

Hata Yönetimi

Örnek otomatik yeniden deneme yapmaz. 429 için Retry-After saniyesi ve İstek Limitleri esas alınır. 401/403 için kimlik, izin ve plan; 402 için abonelik kontrol edilir. Bağlantı veya JSON ayrıştırma hatası başarılı boş listeye dönüştürülmez. Hata ilişkilendirmesi için requestId saklanabilir; API anahtarı ve Webhook imza anahtarı günlüğe yazılmaz.

Katalog ve Olay API’leri İçin Kaynak SDK

Aşağıdaki metotlar depodaki kaynak SDK’ya aittir. Paket yayını gerektiren kurulumlar için yukarıdaki yayın durumunu ayrıca doğrulayın.

Metotİstek
client.catalog.search({ q, limit })GET /api/v1/catalog/search
client.catalog.getRegulation(id, { contentSource })GET /api/v1/catalog/regulations/{id}
client.catalog.sectorTaxonomyActive()GET /api/v1/catalog/sector-taxonomy/active
client.catalog.sectorTaxonomyNodes({ parentKey })GET /api/v1/catalog/sector-taxonomy/nodes
client.events.list({ after, types, limit })GET /api/v1/events
client.listChanges({ cursor: '', limit: 5 })GET /api/v1/changes
client.webhooks.test(id, { eventType: 'NEW_REGULATION' })POST /api/v1/webhooks/{id}/test

events.list içindeki types virgülle ayrılmış tür dizesidir; after imleci ile filtre kümesi korunur. Yanıt items, next_cursor, has_more taşır. changes ilk imleç isteği boş cursor gönderir; page ile birlikte kullanılmaz. Sonraki sayfa meta.nextCursor ile istenir. Süresi dolmuş imleç 410 verir. Katalog ve değişiklik kayıtları additive effectiveDate, taxTags, app_url, public_url alanlarını korur. Açık tarih yoksa effectiveDate: null, eşleşme yoksa taxTags: []; kamuya açık olmayan belgede public_url: null döner.

Çalıştırılabilir örnek: apps/docs/examples/phase-two.ts; kardeş spec’i istek yollarını, gövdeleri ve hata davranışını doğrular. Webhook test çağrısı sentetik teslimat oluşturduğu için okuma örneğinden ayrı çağrılır.