• Durum Kodu (Status Code): Sunucunun isteğe verdiği cevabın sonucunu gösteren üç haneli bir sayıdır (örn. 200 OK, 404 Not Found, 500 Internal Server Error). `response.status_code` veya `response.status` gibi niteliklerle erişilir. Bu kod, isteğin genel sonucunu hızlıca anlamanızı sağlar.
• Başlıklar (Headers): Yanıtla birlikte gönderilen meta verilerdir (örn. `Content-Type`, `Date`, `Server`, `X-RateLimit-Remaining`). `response.headers` genellikle bir sözlük benzeri obje olarak erişilebilir ve anahtar-değer çiftleri şeklinde bilgiler içerir. Bu başlıklar, önbelleğe alma stratejilerinden, kimlik doğrulama belirteçlerine kadar birçok farklı senaryoda kullanılır.
• Yanıt Gövdesi (Body): Sunucudan gelen asıl veridir. Metin, JSON, ikili veri (resim, dosya) veya boş olabilir. `response.text` (metin), `response.json()` (JSON), `response.content` (ikili) gibi yöntemlerle erişilir. Gövde, genellikle API'den beklenen iş verisini taşır.
• İsteğin Başarısı (Success/OK): Genellikle 2xx durum kodları için `True` dönen bir boolean niteliktir. `response.ok` şeklinde kullanılır. Bu, hızlı bir başarı kontrolü için oldukça kullanışlıdır.
• URL (Original Request URL): Yanıtın alındığı son URL'yi gösterir. Yönlendirmeler sonrası nihai URL'yi bulmak için kullanışlıdır.
• Süre (Elapsed Time): İsteğin başlamasından yanıtın alınmasına kadar geçen süreyi gösterir. Performans analizi için önemlidir.

# Bir SDK'da HTTP yanıtı örneği (Python benzeri sözde kod)
import sdk

try:
    # SDK'nın bir API metodunu çağırıyoruz
    response = sdk.service.get_user_profile(user_id="123")

    # Yanıtın başarılı olup olmadığını kontrol edin
    if response.ok: # Bu genellikle 200-299 arası durum kodları için True döner
        print(f"İstek başarılı! Durum Kodu: {response.status_code}")
        print(f"Content-Type Başlığı: {response.headers.get('Content-Type', 'Belirtilmemiş')}")
        print(f"API Yanıt Süresi: {response.elapsed.total_seconds():.2f} saniye")

        # Yanıt gövdesini Content-Type'a göre işle
        if response.headers.get('Content-Type', '').startswith('application/json'):
            user_data = response.json()
            print(f"Kullanıcı Adı: {user_data.get('name')}, Email: {user_data.get('email')}")
        else:
            print(f"Beklenmeyen yanıt formatı: {response.text[:100]}...")
    else:
        # Hata durumunda
        print(f"Hata oluştu! Durum Kodu: {response.status_code}")
        print(f"Hata Açıklaması (Reason): {response.reason}")
        if response.headers.get('Content-Type', '').startswith('application/json'):
            error_details = response.json()
            print(f"API Hata Kodu: {error_details.get('code')}, Mesaj: {error_details.get('message')}")
        else:
            print(f"Hata Detayı: {response.text}")

except sdk.exceptions.ConnectionError as e:
    print(f"Bağlantı Hatası: Sunucuya ulaşılamadı veya ağ sorunu: {e}")
except sdk.exceptions.Timeout as e:
    print(f"Zaman Aşımı Hatası: İstek belirtilen sürede tamamlanamadı: {e}")
except sdk.exceptions.RequestException as e:
    print(f"Genel İstek Hatası: {e}")
except Exception as e:
    print(f"Beklenmeyen bir genel hata oluştu: {e}")

• JSON Verisi: Çoğu modern REST API, veri alışverişi için JSON kullanır. `response.json()` metodu, JSON formatındaki bir gövdeyi doğrudan programlama dilinizin karşılık gelen veri yapısına (örn. Python'da sözlük veya liste) dönüştürür. İşlemeden önce Content-Type başlığının `application/json` olduğundan emin olmak iyi bir pratiktir. JSON, karmaşık veri yapılarını kolayca temsil edebilmesi ve hem insanlar hem de makineler tarafından okunabilir olması nedeniyle yaygın olarak tercih edilir. Ancak, hatalı biçimlendirilmiş bir JSON yanıtı, ayrıştırma hatalarına yol açabilir, bu yüzden `try-except` blokları kullanmak önemlidir.
  
  
  Kod:

  # JSON yanıtını güvenli bir şekilde ayrıştırma
  if response.headers.get('Content-Type', '').startswith('application/json'):
      try:
          data = response.json()
          if 'items' in data and isinstance(data['items'], list):
              for item in data['items']:
                  print(f"Öğe ID: {item.get('id')}, Adı: {item.get('name')}")
          elif 'error' in data:
              print(f"API Hata Mesajı: {data['error'].get('message')}")
      except ValueError as e: # JSON ayrıştırma hatası
          print(f"Yanıt geçerli bir JSON değil veya ayrıştırma hatası: {e}")
          print(f"Ham Yanıt Metni: {response.text[:200]}...")
  else:
      print("Yanıt JSON formatında değil, bekleniyor: application/json")

• Metin Verisi: Bazen API'ler düz metin (plain text), HTML veya XML yanıtları döndürebilir. `response.text` niteliği, yanıt gövdesini bir dize olarak sağlar. Bu, hata mesajları, loglar veya basit bilgi metinleri için kullanışlıdır. Özellikle hata durumlarında, API'nin hata detaylarını insan tarafından okunabilir metin olarak döndürmesi yaygındır.
  
  
  Kod:

  # Metin veya HTML yanıtını işleme
  content_type = response.headers.get('Content-Type', '')
  if content_type.startswith('text/plain') or \
     content_type.startswith('text/html') or \
     content_type.startswith('application/xml'):
      text_content = response.text
      print(f"Metin/HTML/XML İçeriği (İlk 200 karakter): {text_content[:200]}...")
      # HTML içeriği ise, bir HTML ayrıştırıcı (parser) kullanılabilir.
      # XML içeriği ise, bir XML ayrıştırıcı kullanılabilir.
  else:
      print("Yanıt beklenen metin/HTML/XML formatında değil.")

• İkili Veri (Binary Data): Dosya indirmeleri (resimler, PDF'ler, ZIP dosyaları, ses dosyaları) gibi durumlarda yanıt gövdesi ikili formattadır. `response.content` niteliği, gövdeyi bayt dizisi (bytes) olarak döndürür ve bu, doğrudan bir dosyaya yazılabilir veya işlenebilir. Bu tür yanıtlar için genellikle `Content-Disposition` başlığı dosya adını içerir.
  
  
  Kod:

  # İkili veriyi dosyaya kaydetme
  content_type = response.headers.get('Content-Type', '')
  if content_type.startswith('image/') or \
     content_type.startswith('application/pdf') or \
     content_type.startswith('application/octet-stream'):
      filename_header = response.headers.get('Content-Disposition')
      filename = "downloaded_file"
      if filename_header and "filename=" in filename_header:
          # Content-Disposition başlığından dosya adını çıkar
          filename = filename_header.split('filename=')[-1].strip('"')
  
      try:
          with open(filename, "wb") as f:
              f.write(response.content)
          print(f"Dosya başarıyla indirildi: {filename}")
      except IOError as e:
          print(f"Dosya yazma hatası: {e}")
  else:
      print("Yanıt beklenen ikili formatta değil.")

"İstemci tarafında `response.ok` kontrolünü yapmak ve başarısız yanıtlar için `status_code`'a göre özelleşmiş hata işleme mantığı uygulamak, uygulamanızın esnekliğini artırır. Örneğin, 401 Unauthorized hatasında oturum açma akışını yeniden başlatabilir, 429 Too Many Requests hatasında bir bekle-tekrar dene (retry) mekanizması tetikleyebilirsiniz. Sunucu hataları (5xx) için ise genellikle kullanıcıya nazik bir hata mesajı göstermek ve sorunu izleme sistemlerine bildirmek en iyi yaklaşımdır."

Genişletmek için tıkla ...

def handle_api_response(response):
    if response.ok:
        print("İşlem Başarılı.")
        return response.json() if response.headers.get('Content-Type', '').startswith('application/json') else response.text
    else:
        status = response.status_code
        error_message = "Hata oluştu, lütfen daha sonra tekrar deneyin."
        error_details = {}

        if response.headers.get('Content-Type', '').startswith('application/json'):
            try:
                error_details = response.json()
                error_message = error_details.get('message', error_message) # API'den gelen mesajı kullan
            except ValueError:
                pass # JSON değilse varsayılan mesajı kullan

        if status == 400:
            print(f"[400] Geçersiz İstek: İstek formatı veya parametreleri hatalı. Detaylar: {error_message}")
        elif status == 401:
            print(f"[401] Yetkilendirme Hatası: Kimlik doğrulama başarısız veya eksik. Oturumunuzun süresi dolmuş olabilir. Detaylar: {error_message}")
            # Yeniden kimlik doğrulama akışını tetikle
        elif status == 403:
            print(f"[403] Erişim Engellendi: Bu kaynağa erişim izniniz yok. Detaylar: {error_message}")
        elif status == 404:
            print(f"[404] Bulunamadı: İstenen kaynak mevcut değil. Detaylar: {error_message}")
        elif status == 409:
            print(f"[409] Çakışma Hatası: İstek, mevcut bir kaynakla çakıştı. Detaylar: {error_message}")
        elif status == 429:
            retry_after = response.headers.get('Retry-After')
            print(f"[429] Çok Fazla İstek: Oran limiti aşıldı. Lütfen {retry_after or 'biraz'} bekleyin ve tekrar deneyin. Detaylar: {error_message}")
            # Üstel geri çekilme ile tekrar dene (Exponential Backoff)
        elif status >= 500 and status < 600:
            print(f"[5xx] Sunucu Hatası: Sunucu tarafında bir sorun oluştu. Lütfen sistem yöneticinizle iletişime geçin. Detaylar: {error_message}")
            # Hata raporlama sistemine detaylı bilgi gönder
        else:
            print(f"[Bilinmeyen Hata] Durum Kodu {status}: {error_message}. Ham Yanıt: {response.text[:200]}...")
        
        # Hata durumunda bir istisna fırlatılabilir
        raise Exception(f"API isteği başarısız oldu: {status} - {error_message}")

# Kullanım örneği:
# try:
#     api_data = handle_api_response(some_sdk_response)
#     print("API'den gelen veriler başarıyla işlendi:", api_data)
# except Exception as e:
#     print(f"Hata yakalandı: {e}")

• Zaman Aşımları (Timeouts): Ağ sorunları, sunucu aşırı yüklenmesi veya yavaş API yanıtları nedeniyle uygulamanızın süresiz beklemesini engellemek için HTTP isteklerine zaman aşımları uygulayın. Hem bağlantı zaman aşımı (sunucuya bağlanma süresi) hem de okuma zaman aşımı (yanıt gövdesini alma süresi) tanımlanmalıdır. Bu, uygulamanızın yanıt vermeye devam etmesini sağlar ve kötü kullanıcı deneyimlerini önler.
• Tekrar Denemeler (Retries): Geçici ağ sorunları (örn. 503 Service Unavailable), sunucu aşırı yüklenmesi veya oran sınırlamaları (örn. 429 Too Many Requests) gibi durumlar için otomatik tekrar deneme mekanizmaları uygulayın. Özellikle üstel geri çekilme (exponential backoff) stratejisi ile denemeler arasındaki bekleme süresini artırarak sunucu üzerindeki yükü azaltmak ve başarılı bir yanıt alma şansını artırmak önemlidir. Her zaman her hatada tekrar deneme yapmaktan kaçının; sadece geçici hatalarda kullanın.
• Bağlantı Havuzlama (Connection Pooling): Aynı hedefe birden fazla istek yapılıyorsa, her istek için yeni bir TCP bağlantısı kurmanın maliyetini azaltmak için bağlantı havuzlama kullanın. Çoğu modern SDK veya HTTP istemci kütüphanesi bunu varsayılan olarak yapar veya kolayca yapılandırılmasını sağlar. Bu, özellikle düşük gecikmeli veya yüksek verimli uygulamalar için önemlidir.
• Yanıt Boyutu Kontrolü ve Akışlı Okuma (Streaming): Çok büyük yanıt gövdeleri, bellek tüketimi ve performans sorunlarına yol açabilir. Özellikle ikili verilerle (büyük dosyalar) çalışırken yanıt boyutunu kontrol etmek veya tüm gövdeyi belleğe yüklemek yerine akışlı okuma (stream) kullanmak önemlidir. Bu, uygulamanızın ölçeklenebilirliğini artırır.
• Hata Mesajı Ayrıştırma ve Kullanıcıya Bildirme: API'ler genellikle hata durumlarında gövdede daha detaylı hata mesajları veya hata kodları döndürür. Bu mesajları ayrıştırarak ve kullanıcıya anlaşılır bir dille sunarak, hataların giderilmesine yardımcı olun. Geliştiriciler için ise, API'den gelen ham hata yanıtını loglamak, sorun tespiti için paha biçilmezdir.
• Logging ve Metrikler: Özellikle üretim ortamında, başarılı ve başarısız tüm HTTP yanıtlarının (ancak hassas veriler hariç) loglanması, sorun giderme, performans izleme ve hata analizi için paha biçilmezdir. Yanıt süreleri, durum kod dağılımları gibi metrikleri toplamak, sisteminizin sağlığı hakkında genel bir bakış sağlar.
• Bellek Yönetimi ve Kaynak Serbest Bırakma: Büyük yanıt gövdeleriyle çalışırken veya çok sayıda eşzamanlı istek yaparken, bellek sızıntılarını önlemek için yanıt objeleri ve ilişkili kaynakların (örn. bağlantılar) doğru bir şekilde kapatıldığından ve serbest bırakıldığından emin olun.