İ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": "Rate limit exceeded",
  "detail": "Çok fazla istek gönderildi"
}

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.