Hız Sınırları (Rate Limits)

Her API key üç seviyede sınırlandırılabilir: dakikalık (varsayılan ve aktif), saatlik ve günlük (opsiyonel, key oluştururken belirlenir).

Varsayılanlar

Pencere	Varsayılan	Durum
Dakikalık	60 istek	Uygulanıyor — her istekte kontrol edilir
Saatlik	Sınırsız (opsiyonel)	Alan mevcut, henüz uygulanmıyor
Günlük	Sınırsız (opsiyonel)	Alan mevcut, henüz uygulanmıyor

Dürüstlük notu: Key oluştururken saatlik/günlük limit girebilirsiniz ve bu değerler GET /api/v1/developer/rate-limit yanıtında görünür, ancak şu an yalnızca dakikalık sınır fiilen zorlanır (isteği reddeder). Saatlik/günlük zorlama yol haritasındadır.

Limit Aşıldığında

{
  "success": false,
  "error": { "code": "rate_limit_exceeded", "message": "Dakikalık istek limitini (60) aştınız." },
  "meta": { "request_id": "req_...", "timestamp": "2026-08-02T10:00:00+00:00", "api_version": "v1" }
}

HTTP durum kodu 429 döner. Bir dakika bekleyip tekrar deneyin.

Anlık Tüketimi Sorgulama

Kendi entegrasyonunuzdan, limitinize ne kadar yaklaştığınızı canlı sorgulayabilirsiniz:

curl https://otomovena.com/api/v1/developer/rate-limit.php \
  -H "Authorization: Bearer otv_live_xxxxx..."

{
  "success": true,
  "data": {
    "limit_per_minute": 60, "used_in_last_minute": 12, "remaining": 48, "window_seconds": 60,
    "limit_per_hour": null, "limit_per_day": null
  }
}

Limit Artırımı

Yoğun entegrasyonlar için Süper Admin, key bazında dakikalık limiti artırabilir. Talep için galeri panelinizden destek talebi açın.