Modern uygulamalarda dış servislerle iletişim kaçınılmazdır. Ancak ağ hataları, servis limitleri ve yanıt süresi gibi sorunlar sıkça karşılaşılır. Bu ders, API istemci deseni üzerinden retry (yeniden deneme), timeout (zaman aşımı) ve backoff (geri çekilme) stratejilerini Python’da nasıl uygulayacağınızı gösterirken, aynı kavramları PHP’de de örnekleyerek anlayışınızı pekiştirecek.
Temel Kavramlar
API istemci deseni, dış bir API’ye yapılan isteklerin güvenilir ve ölçeklenebilir bir şekilde yönetilmesini sağlar. En kritik üç unsur:
- Retry: Başarısız istekleri belirli bir sayıda tekrar deneme.
- Timeout: Bir isteğin ne kadar süre içinde yanıt vermesi gerektiği.
- Backoff: Tekrar denemeler arasında artan bekleme süresi (ör. eksponansiyel backoff).
Bu unsurlar, tenacity gibi kütüphanelerle kolayca uygulanabilir; aynı zamanda kendi sarmalayıcınızı yazarak tam kontrol elde edebilirsiniz.
Adım Adım Uygulama
Aşağıdaki adımları izleyerek bir API istemcisi oluşturacağız:
- Temel
requestsçağrısını hazırlayın. - Timeout parametresini ekleyin.
- Retry ve backoff mantığını
tenacitydekoratörüyle sarmalayın. - Hata durumlarını loglayın ve gerektiğinde özel istisna fırlatın.
İlk adımda basit bir GET isteği:
import requests
response = requests.get('https://api.example.com/data')
print(response.json())
Timeout eklemek için timeout=5 gibi bir değer kullanılır; bu, 5 saniye içinde yanıt alınmazsa requests.exceptions.Timeout hatasını tetikler.
response = requests.get('https://api.example.com/data', timeout=5)
Şimdi tenacity ile retry ve backoff ekleyelim:
from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_exception_type
@retry(
stop=stop_after_attempt(4),
wait=wait_exponential(multiplier=1, min=2, max=10),
retry=retry_if_exception_type(requests.exceptions.RequestException)
)
def get_data():
return requests.get('https://api.example.com/data', timeout=5)
try:
resp = get_data()
resp.raise_for_status()
print(resp.json())
except Exception as e:
print(f'İstek başarısız: {e}')
Bu kod, maksimum 4 deneme yapar; her deneme arasında 2, 4, 8 saniyelik artan bekleme süresi bulunur. Böylece servis geçici olarak meşgulse, istemci hemen vazgeçmez.
PHP Örnekleri
Python’da gördüklerinizi PHP’de de aynı mantıkla uygulayabilirsiniz. Aşağıdaki iki örnek, cURL ile timeout ve retry (basit bir döngü) kullanımını gösterir.
<?php
function curl_get($url, $timeout = 5) {
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($ch);
$err = curl_error($ch);
curl_close($ch);
if ($err) {
throw new Exception($err);
}
return $response;
}
try {
$data = curl_get('https://api.example.com/data');
echo $data;
} catch (Exception $e) {
echo 'Hata: ' . $e->getMessage();
}
?>
Yukarıdaki fonksiyon tek bir deneme yapar. Şimdi basit bir retry mekanizması ekleyelim.
<?php
function curl_get_with_retry($url, $maxAttempts = 4, $baseDelay = 2) {
$attempt = 0;
while ($attempt < $maxAttempts) {
try {
return curl_get($url);
} catch (Exception $e) {
$attempt++;
if ($attempt >= $maxAttempts) {
throw $e; // Son denemede hatayı yeniden fırlat
}
$delay = $baseDelay * pow(2, $attempt - 1); // Eksponansiyel backoff
sleep($delay);
}
}
}
try {
$data = curl_get_with_retry('https://api.example.com/data');
echo $data;
} catch (Exception $e) {
echo 'Tüm denemeler başarısız: ' . $e->getMessage();
}
?>
Bu örnek, her başarısız denemeden sonra 2, 4, 8 saniyelik bekleme süresi ekler ve maksimum 4 deneme yapar.
Sık Karşılaşılan Hatalar
- Timeout ayarının çok düşük olması: Ağ gecikmesi yüksek ortamda 1 saniyelik timeout hemen başarısızlığa yol açar. Çoğu durumda 5‑10 saniye daha uygundur.
- Retry döngüsünün sonsuz olması:
while(true)gibi yapılar sistem kaynaklarını tüketir.stop_after_attemptya da bir sayaç kullanarak sınır koyun. - Backoff süresinin sabit kalması: Tekrarlanan hatalar aynı anda tekrar eder ve servis üzerindeki yük artar. Eksponansiyel backoff, bu sorunu azaltır.
- Hatalı istisna yakalama: Sadece ağ hatalarını yeniden denemek gerekir; 4xx (client error) hataları genellikle tekrar denemeyi hak etmez.
Özet
Bu derste, API istemci deseniyle ilgili üç temel stratejiyi (retry, timeout, backoff) hem Python hem de PHP ortamında nasıl hayata geçireceğinizi adım adım gösterdik. Özetle:
- İsteklerin zaman aşımını belirleyin; aksi takdirde istemci sonsuza kadar bekleyebilir.
- Geçici hatalar için sınırlı sayıda yeniden deneme yapın.
- Denemeler arasında artan bekleme süresi (eksponansiyel backoff) uygulayarak servis üzerindeki yükü dengeleyin.
- Hata tipine göre yeniden deneme kararını özelleştirin; 5xx hataları genellikle yeniden denemeye uygundur.
Bu prensipleri projelerinizde uyguladığınızda, dış servislerle daha dayanıklı ve ölçeklenebilir bir iletişim kurabilirsiniz.
Sık Sorulan Sorular
S1: Retry sayısını çok yüksek ayarlamak sistemimi yavaşlatır mı?
Evet. Çok yüksek bir limit, özellikle uzun backoff süreleriyle birleştiğinde yanıt süresini artırır. Genellikle 3‑5 deneme yeterli olur.
S2: Timeout süresini nasıl belirlemeliyim?
Servisin ortalama yanıt süresini ölçün, ardından bir güvenlik marjı ekleyin. Kritik işlemler için daha kısa, veri toplama gibi düşük öncelikli işlemler için daha uzun timeout kullanılabilir.
S3: Tenacity yerine kendi retry mantığımı yazabilir miyim?
Tabii ki. Ancak tenacity, çok çeşitli senaryolar (ör. jitter ekleme) için test edilmiş bir çözümdür ve kodunuzu sadeleştirir.
- Temel kavramı bir başkasına anlatabildiniz mi?
- Küçük bir örnek uyguladınız mı?
- Karşılaştığınız sorunları not aldınız mı?
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.