Limitler & Önbellek
Edge önbellekleme davranışı, hız limitleri ve 429 yönetimi.
API, Cloudflare arkasında servis edilir. İki davranışı bilmek işine yarar: edge önbellek ve hız limiti.
Edge önbellek
Yanıtlar Cloudflare edge'inde API anahtarı başına kısa süreli önbeklenir (~180 saniye). Bu pencere içinde birebir aynı sorguyu (aynı parametreler, aynı anahtar) tekrarlarsan origin'e gitmeden önbellekten dönebilir.
Pratik sonuçlar:
- Aynı raporu saniyeler içinde tekrar çekmek hızlıdır ve ucuzdur.
- Veri ~3 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ı |
|---|---|
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.