Genel

API Testi: Postman, Newman ile Otomasyona Geçiş

yazar

API Testi: Postman ile Manuel Testlerden Newman ile Otomasyona

Günümüzün yazılım geliştirme dünyasında, API’ler (Uygulama Programlama Arayüzleri) uygulamaların birbiriyle ve dış dünya ile iletişim kurmasını sağlayan kritik bileşenler haline gelmiştir. Bu nedenle, API’lerin doğru, güvenilir ve performanslı bir şekilde çalıştığından emin olmak, yazılım kalitesi ve kullanıcı deneyimi açısından hayati önem taşır. Bu makalede, API testlerinin önemini, manuel testler için Postman’in nasıl kullanıldığını ve Newman ile bu testlerin nasıl otomatikleştirilerek CI/CD (Sürekli Entegrasyon/Sürekli Dağıtım) süreçlerine entegre edilebileceğini inceleyeceğiz. API testleri, yazılım geliştirme yaşam döngüsünün ayrılmaz bir parçasıdır ve bu makale boyunca, bu testlerin neden bu kadar önemli olduğunu ve pratik uygulamalarını örneklerle detaylandıracağız. API lerin doğru çalıştığından emin olmak için gerekli adımlar açıklanacaktır.

API Testlerinin Önemi

API’ler, modern yazılım mimarilerinin temel yapı taşlarıdır. Bir API’nin hatalı çalışması, zincirleme reaksiyonlara yol açarak uygulamanın tamamında veya farklı servislerde beklenmedik sorunlara neden olabilir. Bu nedenle, API testleri, yazılım geliştirme sürecinin erken aşamalarında ve sürekli olarak yapılmalıdır. API testleri ile:

  • Fonksiyonellik Doğrulaması: API’nin beklenen girdilere doğru çıktıları verdiğinden, farklı senaryolarda doğru çalıştığından emin olunur.
  • Performans Testi: API’nin yanıt sürelerinin kabul edilebilir sınırlar içinde olup olmadığı, yüksek yük altında nasıl davrandığı test edilir.
  • Güvenlik Testi: API’nin yetkilendirme, kimlik doğrulama ve veri güvenliği gibi güvenlik gereksinimlerini karşılayıp karşılamadığı kontrol edilir.
  • Hata Yönetimi: API’nin hatalı durumlarda doğru hata mesajlarını dönüp dönmediği ve hataları nasıl ele aldığı test edilir.
  • Entegrasyon Testleri: API uç noktaları arasındaki veri alışverişi beklendiği gibi çalışır.

API testleri, sadece hataları erken tespit etmekle kalmaz, aynı zamanda yazılımın genel kalitesini artırır, geliştirme sürecini hızlandırır ve uzun vadede maliyetleri düşürür.

Postman ile Manuel API Testleri

Postman, API’leri test etmek, geliştirmek ve dokümante etmek için kullanılan popüler bir araçtır. Postman’in kullanıcı dostu arayüzü sayesinde, API istekleri (GET, POST, PUT, DELETE vb.) kolayca oluşturulabilir, gönderilebilir ve yanıtları incelenebilir. Postman ile API testlerini manuel olarak yapmak için:

  • İstek Oluşturma: Test edilecek API’nin URL’i, istek metodu (GET, POST, vb.), başlıklar (headers), parametreler ve gövde (body) bilgileri girilir.
  • İstek Gönderme: Oluşturulan istek, “Send” butonuna tıklanarak API’ye gönderilir.
  • Yanıtı İnceleme: API’den dönen yanıtın durum kodu (status code), başlıkları, gövdesi ve yanıt süresi incelenir.
  • Test Senaryoları Oluşturma: Postman’in “Tests” bölümü kullanılarak, JavaScript ile çeşitli test senaryoları yazılabilir. Bu senaryolar, yanıtın içeriğini, durum kodunu, başlıklarını ve diğer özelliklerini doğrulamak için kullanılır.
    Örnek:

    pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
    });

Postman, manuel testler için güçlü bir araç olsa da, büyük ve karmaşık projelerde testlerin sürekli olarak tekrarlanması zaman alıcı ve hataya açık olabilir.

Newman ile API Test Otomasyonu

Newman, Postman koleksiyonlarını (collection) komut satırından çalıştırmayı sağlayan bir araçtır. Bu sayede, Postman’de oluşturulan API testleri otomatikleştirilebilir ve CI/CD süreçlerine entegre edilebilir. Newman’i kullanmak için:

  • Postman Koleksiyonunu Dışa Aktarma: Postman’de oluşturulan test koleksiyonu, JSON formatında dışa aktarılır.
  • Newman’i Kurma: Newman, npm (Node Package Manager) aracılığıyla kurulur: npm install -g newman
  • Testleri Komut Satırından Çalıştırma: Newman, dışa aktarılan koleksiyon dosyasını ve isteğe bağlı olarak ortam değişkenlerini (environment variables) parametre olarak alarak testleri çalıştırır: newman run mycollection.json -e myenvironment.json
  • Raporlama: Newman, test sonuçlarını komut satırında ve isteğe bağlı olarak HTML, JUnit veya JSON formatlarında raporlayabilir.

Newman, API testlerinin otomatikleştirilmesini sağlayarak, testlerin her kod değişikliğinden sonra veya belirli aralıklarla otomatik olarak çalıştırılmasına olanak tanır.

CI/CD Entegrasyonu ve Sürekli Test

API test otomasyonunun en önemli avantajlarından biri, testlerin CI/CD pipeline’larına entegre edilebilmesidir. Bu sayede, her kod değişikliği veya yeni sürüm yayınlandığında, API testleri otomatik olarak çalıştırılır ve olası hatalar erken aşamada tespit edilir. CI/CD entegrasyonu için:

  • CI/CD Aracı Seçimi: Jenkins, GitLab CI, GitHub Actions, Azure DevOps gibi bir CI/CD aracı seçilir.
  • Pipeline Tanımlama: CI/CD aracında, API testlerinin çalıştırılacağı bir pipeline (iş akışı) tanımlanır. Bu pipeline, genellikle kodun derlenmesi, testlerin çalıştırılması ve uygulamanın dağıtılması gibi adımları içerir.
  • Newman Komutunu Ekleme: Pipeline’ın test adımına, Newman komutu eklenir. Bu komut, Postman koleksiyonunu çalıştırır ve test sonuçlarını raporlar.
  • Test Sonuçlarını Değerlendirme: CI/CD aracı, Newman’ın döndürdüğü test sonuçlarını değerlendirir. Eğer testler başarısız olursa, pipeline durdurulur ve geliştiricilere bildirim gönderilir.

Bu entegrasyon, API’lerin sürekli olarak test edilmesini sağlayarak, yazılım kalitesini artırır ve hataların üretim ortamına ulaşmasını engeller.

Sonuç

API testleri, modern yazılım geliştirme süreçlerinin vazgeçilmez bir parçasıdır. Postman, API’leri manuel olarak test etmek için kullanıcı dostu bir arayüz sunarken, Newman bu testleri otomatikleştirerek CI/CD süreçlerine entegre etmeyi sağlar. Bu makalede, API testlerinin önemini, manuel testler için Postman’in nasıl kullanılacağını, Newman ile test otomasyonunun nasıl gerçekleştirileceğini ve bu testlerin CI/CD pipeline’larına nasıl entegre edileceğini detaylı bir şekilde inceledik. API’lerin doğru, güvenilir ve performanslı bir şekilde çalıştığından emin olmak, yazılım kalitesi ve kullanıcı deneyimi açısından büyük önem taşır. Manuel ve Otomatik testler arasındaki fark ve bu testleri otomatikleştirmek için ne yapılması gerektiğini de açıkladık. Sürekli test yaklaşımı, hataların erken aşamada tespit edilmesini, geliştirme sürecinin hızlanmasını ve uzun vadede maliyetlerin düşmesini sağlar.

Bir yanıt yazın