Hız Sınırlama (Rate Limiting)

Public API her API key için dakikada 100 istek sliding window ile sınırlandırılmıştır. Sınır aşıldığında istek 429 Too Many Requests ile reddedilir.

Sınır detayları

Boyut	Değer
Limit	100 istek / dakika
Pencere	Sliding 60 saniye, 6 segment (10s)
Anahtar	`X-Api-Key` header değeri
Anonim (auth öncesi)	IP başına ayrı sınır (aynı limit)

429 yanıtı

429 Too Many Requests

Retry-After: 12
Content-Type: application/problem+json

Body

{
  "type": "https://public-api.epinpark.com/problems/rate-limit-exceeded",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Request limit (100/min) exceeded.",
  "correlationId": "abc123"
}

Retry-After header'ı saniye cinsinden bekleme süresini söyler.

Hız limitiyle başa çıkma

En iyi pratikler

Sınırı dolduran tipik hatalar

Polling intervalinizi çok kısa tutmayın (5 dakikadan kısa nadiren gerekir)
Her döngüde aynı listeyi baştan değil updatedAtFrom cursor ile çekin
N+1 sorgu deseni yerine pageSize=100 ile toplu çekin
Birden fazla seller için aynı anahtarı kullanmayın — anahtar başına sınır var

Sınırı yetmiyorsa

Yüksek hacimli entegrasyonlar için Epinpark satıcı destek ekibine yazın, kullanım profilinize göre özel limit ayarlayabiliriz.

Server-side koruma

Hız sınırlayıcı, kimlik doğrulamadan önce çalışır. Bu sayede geçersiz imzayla yapılan brute-force denemeleri downstream servislerimize ulaşmadan engellenir.