Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 95 – API istemci deseni

Python’da API istemci deseni, retry, timeout ve backoff mekanizmalarını adım adım öğrenin; PHP örnekleriyle kavramları pekiştirin.

Ders 95 – API istemci deseni

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:

  1. Temel requests çağrısını hazırlayın.
  2. Timeout parametresini ekleyin.
  3. Retry ve backoff mantığını tenacity dekoratörüyle sarmalayın.
  4. 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_attempt ya 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ı?
Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

Python ile web, veri, otomasyon ve AI alanlarına yön veren ileri seviye bir yol haritası, adım ad…

Ders 99 – Kontrol listesi: üretim

Üretim ortamı için log, health, config ve secret yönetimini kapsayan kontrol listesi, adım adım ö…

Ders 98 – Mikroservis iletişimi fikri

Mikroservis mimarisinde HTTP/JSON sözleşmesiyle versiyonlu endpoint oluşturma, adım adım örnekler…

Ders 97 – Veri doğrulama katmanı

Veri doğrulama katmanını Pydantic ve Cerberus ile nasıl kuracağınızı adım adım öğrenin, örnek PHP…

Demo
Büyütülmüş Görsel