Limitler & Önbellek
Edge önbellekleme davranışı, hız limitleri ve 429 yönetimi.
API, Cloudflare arkasında servis edilir. Üç davranışı bilmek işine yarar: veri aralığı limiti, edge önbellek ve hız limiti.
Veri aralığı limiti
Tek bir istekte sorgulanan tarih aralığı (from–to) en fazla 90 gün olabilir.
Daha geniş aralık 400 Bad Request döner.
Daha uzun dönem için aralığı 90 günlük parçalara böl ve sonuçları kendi tarafında birleştir.
Edge önbellek
Yanıtlar Cloudflare edge'inde API anahtarı başına önbeklenir (30 dakika). Bu pencere içinde birebir aynı sorguyu (aynı parametreler, aynı anahtar) tekrarlarsan origin'e gitmeden önbellekten dönebilir.
Pratik sonuçlar:
- Aynı raporu tekrar çekmek hızlıdır ve ucuzdur.
- Veri ~30 dakikaya kadar gecikmeli olabilir; gerçek-zamanlı değildir.
- Önbellek anahtara bağlıdır — farklı anahtarlar birbirinin verisini görmez.
İpucu: Tek bir parametreyi (ör.
tosaniyesini) değiştirmek farklı bir önbellek anahtarı üretir ve önbelleği atlar.
Hız limiti
Aşırı/otomatik trafiği önlemek için istekler Cloudflare üzerinde hız limitine
tabidir. Sınırı aşarsan 429 Too Many Requests alırsın.
429 yönetimi
- İstek hacmini düşür; mümkünse sonuçları kendi tarafında önbekle.
- Exponential backoff uygula (ör. 1s, 2s, 4s, 8s) ve tekrar dene.
- Toplu çekimlerde istekleri serileştir veya araya gecikme koy; paralel patlama yapma.
İlgili durumlar
| Durum | Anlamı |
|---|---|
400 Bad Request | Tarih aralığı 90 günü aştı (veya başka geçersiz parametre) |
429 Too Many Requests | Hız limiti aşıldı — backoff ile tekrar dene |
5xx | Geçici origin/edge hatası — kısa beklemeyle tekrar dene |
Tüm hata kodları → Hatalar.