• 400 Bad Request: İstek sözdizimsel olarak hatalı veya geçersiz parametreler içeriyor.
• 401 Unauthorized: İstek kimlik doğrulama bilgisi gerektiriyor veya kimlik doğrulama başarısız.
• 403 Forbidden: İstemcinin kaynağa erişim izni yok.
• 404 Not Found: İstenen kaynak sunucuda bulunamadı.
• 405 Method Not Allowed: HTTP metodunun (GET, POST vb.) kullanılan kaynağa izin verilmiyor.
• 429 Too Many Requests: İstemci belirli bir süre içinde çok fazla istek gönderdi (oran sınırlaması). SDK'lar genellikle bu durumda otomatik yeniden deneme mekanizmaları içermelidir, `Retry-After` başlığını kontrol ederek uygun bir gecikmeyle.

"Bir SDK geliştirirken, 4xx hatalarını sadece birer hata kodu olarak görmek yerine, geliştiriciye anlamlı geri bildirimler sunan kritik bilgiler olarak ele almak önemlidir. Aksi takdirde, hata ayıklama süreci kabusa dönebilir."

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

try:
    if sdk_http_response.status_code == 404:
        raise ResourceNotFoundError("İstenen kaynak bulunamadı.")
    elif sdk_http_response.status_code == 401:
        raise AuthenticationError("Kimlik doğrulama hatası.")
    # Diğer hata durumları...
except (ResourceNotFoundError, AuthenticationError) as e:
    print("Hata oluştu:", e)

• 500 Internal Server Error: Sunucuda beklenmedik bir hata oluştu.
• 502 Bad Gateway: Ağ geçidi veya proxy sunucusundan geçersiz yanıt alındı.
• 503 Service Unavailable: Sunucu şu anda isteği işleyemiyor (bakım, aşırı yük vb.). Bu durumda SDK'lar, yine `Retry-After` başlığına bakarak akıllı yeniden denemeler yapabilir.
• 504 Gateway Timeout: Ağ geçidi veya proxy sunucusu, yukarı akış sunucusundan zamanında yanıt alamadı.

• JSON: En yaygın formatlardan biridir. SDK, JSON dizesini ayrıştırıp bir programlama dili nesnesine (sözlük/harita veya sınıf) dönüştürür.
  
  Kod:

  # sdk_http_response.json() metodu
  # Content-Type: application/json varsayımıyla
  user_data = sdk_http_response.json()
  print("Kullanıcı Adı:", user_data.get("username"))

• XML: Daha az yaygın olsa da, bazı eski API'lar XML kullanabilir. SDK'lar, XML ayrıştırıcıları (parsers) kullanarak veriye erişim sağlar.
• Düz Metin (Plain Text): Bazen hata mesajları veya basit yanıtlar düz metin olarak dönebilir.
  
  Kod:

  # sdk_http_response.text metodu
  error_message = sdk_http_response.text
  print("Sunucudan dönen ham metin:", error_message)

• İkili Veri (Binary Data): Dosya indirmeleri gibi durumlarda yanıt gövdesi ikili veri olabilir. SDK'lar bu veriyi doğrudan bir bayt akışı veya dosya olarak sunar.

• Anlamlı Hata Mesajları: SDK, API'dan dönen genel hata kodlarını, geliştiricinin anlayabileceği daha spesifik ve eyleme dönüştürülebilir hata mesajlarına dönüştürmelidir.
• Yanıt Detaylarına Erişim: Geliştiricilerin, hata durumunda bile ham yanıt başlıklarına, durum koduna ve gövdesine erişebilmesi önemlidir. Bu, sorunun kaynağını anlamak için değerli bilgiler sunar.
• Gelişmiş Günlük Kaydı (Logging): SDK'lar, HTTP isteklerini ve yanıtlarını detaylı bir şekilde günlüğe kaydedebilmelidir. Bu, özellikle üretim ortamlarında sorun giderme için vazgeçilmezdir.

• Yeniden Deneme Mekanizmaları: Özellikle 429 (Too Many Requests) ve 5xx durum kodları için önemlidir. Üstel geri çekilme (exponential backoff) genellikle en iyi stratejidir; bu, her başarısız denemeden sonra beklenen süreyi artırır.
  
  Kod:

  # Basit bir yeniden deneme mantığı örneği
  max_retries = 5
  for attempt in range(max_retries):
      response = make_api_call() # Varsayımsal API çağrısı
      if response.status_code not in [429, 500, 502, 503, 504]:
          break # Başarılı veya başka bir hata kodu, döngüyü kır
      print(f"Yeniden deneme {attempt+1}. HTTP Durum Kodu: {response.status_code}")
      time.sleep(2 ** attempt) # Üstel geri çekilme
  else:
      print("Maksimum yeniden deneme sayısına ulaşıldı, işlem başarısız.")

• Zaman Aşımları: Bir isteğin ne kadar süreyle yanıt bekleyeceğini tanımlar. Bağlantı zaman aşımları ve okuma zaman aşımları olmak üzere iki türü vardır. Doğru zaman aşımlarının ayarlanması, uygulamanın donmasını veya uzun süre yanıt bekleyerek kaynak tüketmesini önler.

• Veri Doğrulama: Yanıt gövdesindeki verilerin beklendiği format ve yapıda olduğunu doğrulamak (şema doğrulama). Kötü niyetli sunucular veya yanıltıcı yanıtlar, bu sayede filtrelenebilir.
• Hassas Bilgilerin Korunması: SDK'lar, hata günlüklerine veya çıktılara hassas bilgileri (API anahtarları, kişisel veriler) sızdırmamaya dikkat etmelidir.
• SSL/TLS Doğrulaması: SDK'nın, sunucu sertifikalarını doğru bir şekilde doğrulaması, MITM (Man-in-the-Middle) saldırılarını önler.