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

Python Örnek İstemcisi

Yayımlanma durumu (24 Ekim 2026): PyPI genel kayıt servisinde  mevzuatradar sorgusu 404 döndürmüştür. PyPI üzerinden kurulabilen resmî SDK yoktur; bu sayfa doğrudan HTTP kullanan örnek istemci sunar. Depodaki packages/sdk-python kaynak paketi, 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-python/mevzuatradar/client.py.

MetotHTTP isteğiİstemcinin kimlik modu
get_public_source_stats()GET /api/v1/public/source-statsKimlik doğrulamasız
list_public_regulations()GET /api/v1/public/regulationsKimlik doğrulamasız
list_changes()GET /api/v1/changesAPI anahtarı
list_deadlines()GET /api/v1/deadlinesAPI anahtarı
list_actions()GET /api/v1/actionsAPI anahtarı
list_verification_reports()GET /api/v1/verification-reportsAPI anahtarı
get_verification_report()GET /api/v1/verification-reports/:idAPI anahtarı
list_board_reports()GET /api/v1/board-reportsAPI anahtarı
get_board_report()GET /api/v1/board-reports/:idAPI anahtarı
get_evidence_pack()GET /api/v1/evidence-packs/:idAPI anahtarı
list_webhooks()GET /api/v1/webhooksJWT veya Enterprise API anahtarı
create_webhook()POST /api/v1/webhooksJWT veya Enterprise API anahtarı
get_webhook()GET /api/v1/webhooks/:idJWT veya Enterprise API anahtarı
update_webhook()PUT /api/v1/webhooks/:idJWT veya Enterprise API anahtarı
delete_webhook()DELETE /api/v1/webhooks/:idJWT veya Enterprise API anahtarı
test_webhook()POST /api/v1/webhooks/:id/testJWT veya Enterprise API anahtarı
rotate_webhook_secret()POST /api/v1/webhooks/:id/rotate-secretJWT veya Enterprise API anahtarı
list_webhook_deliveries()GET /api/v1/webhooks/:id/deliveriesJWT veya Enterprise API anahtarı

Korunan okuma metotları bu istemcide api_key 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 api_key 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.

Kaynak Python paketi requests bağımlılığı kullanır; aşağıdaki standart kitaplık örneğinden farklıdır.

Kurulum ve Kimlik Doğrulama

Örnek Python 3.10 ve üzeri standart kitaplık işlevlerini kullanır; pip install mevzuatradar veya requests kurulumu gerektirmez. 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 kaynak koda veya günlüğe 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. Aşağıda beş kayıt istenir. Liste dış JSON zarfının data.items alanındadır.

import json import os import urllib.error import urllib.parse import urllib.request class RejectRedirects(urllib.request.HTTPRedirectHandler): def redirect_request(self, req, fp, code, msg, headers, newurl): return None def main(): api_key = os.environ["MEVZUATRADAR_API_KEY"] query = urllib.parse.urlencode({"page": 1, "limit": 5, "sourceCode": "BDDK"}) url = f"https://api.mevzuatradar.com/api/v1/changes?{query}" request = urllib.request.Request(url, headers={"x-api-key": api_key}) opener = urllib.request.build_opener(RejectRedirects()) try: with opener.open(request, timeout=20) as response: payload = json.load(response) except urllib.error.HTTPError as error: retry_after = error.headers.get("Retry-After", "") request_id = error.headers.get("X-Request-Id", "") raise RuntimeError( f"HTTP {error.code}; requestId={request_id}; retryAfter={retry_after}" ) from error if payload.get("success") is not True: raise RuntimeError(payload.get("error", "API error")) for change in payload["data"]["items"]: print(change["id"], change["title"]) print("page", payload["data"]["page"], "totalPages", payload["data"]["totalPages"]) if __name__ == "__main__": main()

Kod changes_client.py adıyla kaydedilip python3 changes_client.py ile çalıştırılır. Sonraki 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.py aynı endpointi limit parametresiyle çağırır ve JSON zarfının tamamı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ı API başarı kanıtı değildir.

Webhook İmzası ve Yönetimi

apps/docs/examples/webhook_verify_v2.py yardımcı dosyası alıcının yanına kopyalandığında aşağıdaki parça istek işleyicisi içinde kullanılır:

import os from webhook_verify_v2 import verify_webhook_v2 valid = verify_webhook_v2( raw_body_bytes, headers.get("X-Webhook-Signature-V2", ""), os.environ["MEVZUATRADAR_WEBHOOK_SECRET"], ) if not valid: # The HTTP handler returns 401 and stops processing here. raise PermissionError("invalid signature") # Persist the verified event and deduplicate before applying side effects.

raw_body_bytes, JSON ayrıştırılmadan önceki ham gövdedir; headers alıcının büyük/küçük harfe duyarsız HTTP başlık nesnesidir. Yardımcı zaman damgalı HMAC ve 300 saniyelik tolerans kontrolü uygular; alıcı HTTP çerçevesi başarısız sonucu 401 yanıtına dönüştürür. Tam sözleşme Webhook Akışı sayfasındadır.

Webhook yönetimi Enterprise webhooks:manage anahtarı veya ADMIN JWT, settings sayfa izni ve Webhook özellik hakkı ister; API anahtarı bu çağrılarda kullanılamaz. Yol ve gövdeler Webhook Abonelikleri API sayfasında açıklanır.

Hata Yönetimi

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

Katalog ve Olay API’leri İçin Kaynak SDK

Metotİstek
client.catalog.search(q="vergi", limit=5)GET /api/v1/catalog/search
client.catalog.get_regulation(id, contentSource="pdf")GET /api/v1/catalog/regulations/{id}
client.catalog.sector_taxonomy_active()GET /api/v1/catalog/sector-taxonomy/active
client.catalog.sector_taxonomy_nodes(parentKey="A")GET /api/v1/catalog/sector-taxonomy/nodes
client.events.list(after=cursor, types="NEW_REGULATION", limit=5)GET /api/v1/events
client.list_changes(cursor="", limit=5)GET /api/v1/changes
client.webhooks.test(id, eventType="NEW_REGULATION")POST /api/v1/webhooks/{id}/test

Kaynak istemci cursor="" değerini korur; page ile birlikte gönderilmez. Olay yanıtı items, next_cursor, has_more taşır. types virgülle ayrılmış bir dizedir; sonraki istekte aynı filtre ve sunucunun verdiği imleç kullanılır. Süresi dolmuş imleç 410 verir. effectiveDate, taxTags, app_url, public_url alanları sözlük yanıtlarında aynen korunur; eksik resmi tarih/kamu yolu null, etiket eşleşmesi yoksa dizi boştur. Webhook yönetimi varsa JWT’yi, yoksa api_key seçeneğini kullanır; anahtar Enterprise webhooks:manage ister. eventType abone olunan türlerden olmalıdır. Bu çağrı sentetik teslimat üretir.

Yerel doğrulama py_compile ve packages/sdk-python/tests ile yapılır. Bu iş Python testlerini GitHub Actions’a bağlamaz; yerel sonuç uzak CI kanıtı değildir.