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.
| Metot | HTTP isteği | İstemcinin kimlik modu |
|---|---|---|
get_public_source_stats() | GET /api/v1/public/source-stats | Kimlik doğrulamasız |
list_public_regulations() | GET /api/v1/public/regulations | Kimlik doğrulamasız |
list_changes() | GET /api/v1/changes | API anahtarı |
list_deadlines() | GET /api/v1/deadlines | API anahtarı |
list_actions() | GET /api/v1/actions | API anahtarı |
list_verification_reports() | GET /api/v1/verification-reports | API anahtarı |
get_verification_report() | GET /api/v1/verification-reports/:id | API anahtarı |
list_board_reports() | GET /api/v1/board-reports | API anahtarı |
get_board_report() | GET /api/v1/board-reports/:id | API anahtarı |
get_evidence_pack() | GET /api/v1/evidence-packs/:id | API anahtarı |
list_webhooks() | GET /api/v1/webhooks | JWT veya Enterprise API anahtarı |
create_webhook() | POST /api/v1/webhooks | JWT veya Enterprise API anahtarı |
get_webhook() | GET /api/v1/webhooks/:id | JWT veya Enterprise API anahtarı |
update_webhook() | PUT /api/v1/webhooks/:id | JWT veya Enterprise API anahtarı |
delete_webhook() | DELETE /api/v1/webhooks/:id | JWT veya Enterprise API anahtarı |
test_webhook() | POST /api/v1/webhooks/:id/test | JWT veya Enterprise API anahtarı |
rotate_webhook_secret() | POST /api/v1/webhooks/:id/rotate-secret | JWT veya Enterprise API anahtarı |
list_webhook_deliveries() | GET /api/v1/webhooks/:id/deliveries | JWT 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.