İstek Limitleri ve Planlar

Public API erişimi billing entitlement truth üzerinden çözülür. Plan quota değerleri ProductPlan.entitlements.usage alanındaki apiCallsMonthly, apiKeysMax ve webhookEndpointsMax değerlerine dayanır.

Plan	Public API	API calls / ay	API key	Webhook endpoint
Starter	Kapalı	0	0	0
Professional	Açık	1.000	2	3
Commercial	Açık	10.000	5	10
Enterprise	Açık	100.000	10	Sözleşmeye bağlı

Per-minute Guard

API key runtime rate limit katmanı dakikalık abuse guard uygular. Rate limit aşıldığında 429 döner ve istemci exponential backoff kullanmalıdır.


{
  "success": false,
  "statusCode": 429,
  "error": "API key hız limiti aşıldı",
  "type": "https://mevzuatradar.com/problems/rate_limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "API key hız limiti aşıldı",
  "requestId": "req_...",
  "errorId": "err_..."
}

error ve detail alanları aynı kullanıcı-dostu mesajı taşır; yanıt ayrıca RFC 9457 alanlarını (type, title, status) ve korelasyon kimliklerini içerir.

Retry Policy

Status	Client davranışı
`429`	`Retry-After` varsa bekle, yoksa exponential backoff
`500`	Idempotent read endpointlerde kısa retry
`401` / `403`	Retry yapma; key, permission veya plan kontrol et

Plan Upgrade

verification:read, reports:read, evidence-packs:read ve webhook yönetimi enterprise-grade yetki ister. Limit artırımı ürün içinden veya sözleşme üzerinden yapılır; client tarafında hardcode limit varsayımı yapılmamalıdır.