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.
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.
Yorumlar
0 gerçek yorumHenüz gerçek okuyucu yorumu yok.
✎ Yorum yaz