GÜNDEMDE

DÜNYADAN TEKNOLOJİ HABERLERİ

→
API contract test: 200 OK dönen bir endpoint yine de nasıl bozuk olabilir?
Yazılım · 2026
Yazılım

API contract test: 200 OK dönen bir endpoint yine de nasıl bozuk olabilir?

Durum kodundan öteye geçip şema, kimlik doğrulama, mobil istemci ve geriye uyumluluğu test etmek için pratik yaklaşım.

Yazılımcının GünlüğüYayımlanma: 16 Kas 20263 dk okuma

HTTP 200 başarı için tek başına yeterli değildir

Bir endpoint 200 döndüğü hâlde istenen kaydı yanlış tesis koduyla eşleştirebilir, sayıları metin olarak döndürebilir veya artık kullanılmayan bir alanı kaldırmış olabilir. Contract test, istemcinin bağımlı olduğu yanıt şemasını ve davranışını kontrol eder. Zorunlu alanların türü, boş değer semantiği, sıralama, sayfalama ve hata kodları açıkça tanımlanmalıdır.

Pozitif, negatif ve sınır örnekleri hazırlayın

Mutlu yol testi yetmez: bilinmeyen kaynak, boş sonuç, çok uzun arama metni, 401 yetkisiz oturum, 403 yetersiz izin ve 429 sınır aşımı farklı durumlar olarak doğrulanmalıdır. SQL parametre bağlama ve güvenli serileştirme ayrı kontrol edilir. Tekil kaynak ID ile iş kaydı arasında eşleştirme yapan API'lerde bir kaydın iki farklı nesneye bağlanmadığı da test edilmelidir.

Sözleşme değişimini yayınla birlikte yönetin

Sunucu alan adı değiştirdiğinde eski mobil istemci hâlâ çevrimiçi olabilir. Eski alanı bir geçiş süresince korumak, sürümlü yanıt vermek veya uyum katmanı yazmak seçeneklerdir. Yapı değişikliğinin maliyetini testlerle görmeden rastgele alan silmek istemcileri kırabilir. Veriyi yanlış yorumlatan sessiz şema değişikliği, açık 500 hatasından daha zor fark edilebilir.

Canlı duman testi bağımlılıkları kapsamalı

Dağıtımdan sonra yalnız sağlık URL'sini değil, bir gerçek liste çağrısını, kimlik korumalı uç noktayı, içerik detayını ve yazma sonrası okumayı kontrol edin. Mobil ve masaüstü aynı API'yi farklı zamanlamayla kullanabilir; yarış ve önbellek davranışını buna göre sınayın. Test verisi üretimde kalıcı iş kaydı oluşturacaksa temizleme ve ayrıştırma politikası önceden belirlenmelidir.

0 okunma

Yorumlar

0 gerçek yorum

Henüz gerçek okuyucu yorumu yok.

✎ Yorum yaz

Yorumlar yayımlanmadan önce incelenir.