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.
| Metot | HTTP isteği | İstemcinin kimlik modu |
|---|---|---|
getPublicSourceStats() | GET /api/v1/public/source-stats | Kimlik doğrulamasız |
listPublicRegulations() | GET /api/v1/public/regulations | Kimlik doğrulamasız |
listChanges() | GET /api/v1/changes | API anahtarı |
listDeadlines() | GET /api/v1/deadlines | API anahtarı |
listActions() | GET /api/v1/actions | API anahtarı |
listVerificationReports() | GET /api/v1/verification-reports | API anahtarı |
getVerificationReport() | GET /api/v1/verification-reports/:id | API anahtarı |
listBoardReports() | GET /api/v1/board-reports | API anahtarı |
getBoardReport() | GET /api/v1/board-reports/:id | API anahtarı |
getEvidencePack() | GET /api/v1/evidence-packs/:id | API anahtarı |
listWebhooks() | GET /api/v1/webhooks | JWT veya Enterprise API anahtarı |
createWebhook() | POST /api/v1/webhooks | JWT veya Enterprise API anahtarı |
getWebhook() | GET /api/v1/webhooks/:id | JWT veya Enterprise API anahtarı |
updateWebhook() | PUT /api/v1/webhooks/:id | JWT veya Enterprise API anahtarı |
deleteWebhook() | DELETE /api/v1/webhooks/:id | JWT veya Enterprise API anahtarı |
testWebhook() | POST /api/v1/webhooks/:id/test | JWT veya Enterprise API anahtarı |
rotateWebhookSecret() | POST /api/v1/webhooks/:id/rotate-secret | JWT veya Enterprise API anahtarı |
listWebhookDeliveries() | GET /api/v1/webhooks/:id/deliveries | JWT 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.