Kullanıcı ekranda her şeyin doğru çalıştığını görebilir. Peki arka planda sistemler gerçekten doğru veri alışverişi yapıyor mu?
API Testi, uygulamanızın servisleri, uç noktaları (endpoint), veri akışları ve sistemler arası iletişimin doğru, güvenli ve tutarlı çalışıp çalışmadığını doğrulayan yazılım test hizmetidir. Vidius Project olarak yalnızca arayüzü değil, kullanıcıların görmediği ancak yazılımın çalışmasını sağlayan arka plan iletişimini de bağımsız bir gözle test ediyoruz. Çünkü birçok kritik hata, ekranda değil; API katmanında ortaya çıkar.
API Testi Nedir?
API (Application Programming Interface), farklı yazılımların birbirleriyle veri alışverişi yapmasını sağlayan iletişim katmanıdır.
Bir mobil uygulamanın giriş yapması, ürün listesini çekmesi, sipariş oluşturması veya ödeme bilgisini göndermesi gibi işlemlerin büyük bölümü arka planda API’ler üzerinden gerçekleşir.
API Testi sırasında bu servislerin;
- Doğru veri döndürüp döndürmediği,
- Beklenen HTTP yanıtlarını verip vermediği,
- Hatalı isteklerde doğru tepki oluşturduğu,
- Yetkilendirme kurallarına uyduğu,
- Veri bütünlüğünü koruduğu
kontrol edilir. Amaç yalnızca 200 OK görmek değil; sistemin doğru davranışı doğru koşullarda üretmesini doğrulamaktır.
API Testi Hangi Durumlarda Yapılır?
API Testi özellikle sistemler arası iletişimin kritik olduğu projelerde büyük önem taşır.
Şu durumlarda uygulanabilir:
- Yeni API geliştirildiğinde: Endpoint’lerin beklenen davranışı doğrulanır.
- Mobil ve web uygulamalarında: Arayüz ile backend arasındaki veri akışı kontrol edilir.
- Mikro servis mimarilerinde: Servislerin birbirleriyle doğru iletişim kurduğu doğrulanır.
- Üçüncü parti entegrasyonlarda: Ödeme, kargo, SMS, e-posta veya ERP servislerinin doğru çalıştığı kontrol edilir.
- Versiyon güncellemelerinde: API değişikliklerinin mevcut istemcileri etkilemediği doğrulanır.
- Yayın öncesinde: Kritik servislerin stabil çalıştığından emin olunur.
API Testinde Nelere Bakılır?
API Testi yalnızca endpoint’in cevap verip vermediğine odaklanmaz. Dönen verinin doğruluğu ve sistem davranışı da değerlendirilir.
Endpoint Doğrulaması
İsteklerin doğru endpoint’e ulaşıp ulaşmadığı ve beklenen yanıtın dönüp dönmediği kontrol edilir.
HTTP Durum Kodları
200, 201, 400, 401, 403, 404, 500 gibi yanıt kodlarının doğru senaryolarda üretildiği doğrulanır.
Request & Response Yapısı
Gönderilen ve dönen JSON verilerinin beklenen şemaya uygunluğu incelenir.
Veri Doğruluğu
Alanların doğru değerlerle döndüğü, eksik veya hatalı veri oluşmadığı kontrol edilir.
Kimlik Doğrulama ve Yetkilendirme
Token, JWT, API Key veya diğer yetkilendirme mekanizmalarının doğru çalışıp çalışmadığı değerlendirilir.
Hata Yönetimi
Geçersiz isteklerde sistemin kullanıcıya ve istemciye doğru hata mesajlarını döndürmesi kontrol edilir.
API Test Süreci Nasıl İlerler?
Her API’nin iş kuralları ve kullanım amacı farklıdır. Bu nedenle test kapsamını servislerin kritikliği ve kullanım senaryolarına göre belirliyoruz.
1. API uç noktalarını ve iş akışını analiz ederiz
Test edilecek servisleri, endpoint’leri, istek–yanıt yapısını ve kritik iş kurallarını inceleriz. Gerekli bilgileri mevcut API tanımları veya geliştirici ekibinden alınan bilgiler doğrultusunda belirleriz.
2. Test senaryolarını oluştururuz
Pozitif, negatif ve sınır durumlarını kapsayan API isteklerini hazırlarız.
3. Servisleri Postman üzerinden test ederiz
Endpoint’leri farklı veri setleri, yetkilendirme senaryoları ve hata durumlarıyla manuel olarak doğrularız. Dönen yanıtları, HTTP durum kodlarını ve veri tutarlılığını kontrol ederiz.
4. Bulguları doğrularız
Tespit edilen sorunların tekrar üretilebilirliğini, etkisini ve hangi koşullarda ortaya çıktığını kontrol ederiz.
5. Sonuçları raporlarız
Endpoint bazlı bulguları, request/response örneklerini, HTTP durum kodlarını ve hata detaylarını geliştirme ekibinin doğrudan kullanabileceği şekilde raporlarız.
API Testi Sonunda Neler Teslim Edilir?
Test kapsamına göre aşağıdaki çıktıları sunabiliriz:
- API test senaryoları
- Endpoint bazlı test sonuçları
- Request ve response örnekleri
- HTTP durum kodu doğrulamaları
- Detaylı hata (bug) raporları
- Tekrar üretim adımları
- Hata önem ve kritiklik seviyeleri
- Veri doğruluğu ve iş kuralı bulguları
- Gerekli görülen iyileştirme önerileri
Amacımız yalnızca teknik bir hata listesi oluşturmak değil; geliştirme ekibinin problemi hızlıca anlayıp çözebileceği net çıktılar sunmaktır.
API Testi ile UI Testi Aynı Şey mi?
Hayır. UI (Arayüz) Testi, kullanıcının gördüğü ekranları ve kullanıcı etkileşimini doğrular. API Testi ise arka planda çalışan servisleri doğrudan test eder. Örneğin bir ürün listesinin ekranda görünmesi UI testinin konusu olabilir. Ancak ürünlerin doğru filtrelerle, eksiksiz veriyle ve doğru HTTP yanıtıyla gelmesi API testinin kapsamına girer. İdeal kalite sürecinde iki yaklaşım birbirini tamamlar.
Neden Vidius Project?
API Testini yalnızca teknik endpoint kontrolleri olarak görmüyoruz. Servislerin iş kurallarını, veri tutarlılığını ve kullanıcıya yansıyan etkilerini birlikte değerlendiriyoruz.
18 yılı aşkın QA deneyimimizi bağımsız bir bakış açısıyla birleştiriyoruz.
Böylece yalnızca geliştiricinin yazdığı servisi değil, o servisin ürün üzerindeki gerçek etkisini de doğrulayabiliyoruz. Çünkü iyi çalışan bir arayüzün arkasında, doğru çalışan API’ler vardır.
Sık Sorulan Sorular
API Testi nedir?
API Testi, yazılım servislerinin veri alışverişini, endpoint’lerini, HTTP yanıtlarını ve iş kurallarını doğrulayan test yöntemidir.
API Testi neden önemlidir?
Arayüz doğru görünse bile arka planda eksik veri, hatalı yetkilendirme veya yanlış iş kuralları oluşabilir. API Testi bu sorunları kullanıcıya ulaşmadan önce tespit etmeye yardımcı olur.
API Testi manuel yapılabilir mi?
Evet. Vidius Project kapsamında API Testleri manuel olarak gerçekleştirilebilir ve gerekli durumlarda farklı istek senaryoları uygulanabilir.
API Testi ile UI Testi arasındaki fark nedir?
UI Testi kullanıcı arayüzünü doğrular. API Testi ise kullanıcıların görmediği servis katmanındaki veri iletişimini ve sistem davranışını test eder.
Test sonunda nasıl bir rapor alacağım?
Endpoint bazlı test sonuçlarını, request/response örneklerini, hata raporlarını, tekrar üretim adımlarını ve teknik bulguları içeren detaylı bir rapor sunulur.
Arayüzün Değil, Verinin de Doğru Çalıştığından Emin Olun
Servislerinizi, veri akışlarınızı ve kritik API’lerinizi bağımsız bir gözle test edelim.