Postman ile API Testi Nasıl Yapılır? Adım Adım Başlangıç Rehberi

Modern yazılım geliştirme süreçlerinde, farklı sistemlerin birbiriyle sorunsuz bir şekilde haberleşmesini sağlayan API'ler (Uygulama Programlama Arayüzleri) hayati bir öneme sahiptir. Geliştirdiğiniz veya entegre ettiğiniz bir servisin doğru çalıştığından emin olmak için düzenli testler yapmanız gerekir. İşte tam bu noktada, geliştiricilerin ve QA mühendislerinin en çok tercih ettiği araçlardan biri olan Postman devreye giriyor. Bu rehberde, Postman ile API testi süreçlerini temelden ileri seviyeye adım adım inceleyecek, istek türlerini, parametreleri ve test otomasyonunu nasıl yapılandıracağınızı öğreneceğiz.

Postman Nedir ve Neden Tercih Edilir?

Postman, API geliştirme, test etme, paylaşma ve belgeleme süreçlerini kolaylaştıran güçlü bir platformdur. İlk olarak basit bir tarayıcı eklentisi olarak ortaya çıkan araç, günümüzde dünya genelinde milyonlarca yazılımcı tarafından masaüstü uygulaması olarak kullanılmaktadır. Postman'in popüler olmasının arkasında kullanıcı dostu arayüzü, güçlü test otomasyonu araçları ve ekip çalışmasına uygun yapısı yatmaktadır.

API testleri, bir uygulamanın arka planındaki mantığın (backend logic) doğru çalışıp çalışmadığını doğrulamak için kritik öneme sahiptir. Kullanıcı arayüzü (UI) henüz hazır olmasa bile, API'ler üzerinden veritabanı işlemlerini, güvenlik protokollerini ve iş kurallarını test edebilirsiniz. Postman, karmaşık kodlar yazmaya gerek kalmadan HTTP istekleri göndermenize ve dönen yanıtları görsel olarak analiz etmenize olanak tanır. Resmi web sitesi üzerinden Postman uygulamasını indirerek hemen çalışmaya başlayabilirsiniz.

Adım Adım Postman ile API Testi Nasıl Yapılır?

Postman ile test yapmaya başlamak oldukça basittir. Süreci daha iyi anlamak için ücretsiz ve açık kaynaklı bir test servisi olan JSONPlaceholder API'sini kullanacağız. Aşağıdaki adımları takip ederek ilk API isteğinizi oluşturabilirsiniz.

1. Çalışma Alanı (Workspace) ve Koleksiyon (Collection) Oluşturma

Postman'i açtığınızda sizi karşılayan arayüzde ilk yapmanız gereken bir "Workspace" oluşturmaktır. Çalışma alanları, projelerinizi organize etmenize yardımcı olur. Ardından, birbiriyle ilişkili istekleri bir arada tutmak için bir "Collection" (Koleksiyon) oluşturun. Koleksiyonlar, test senaryolarınızı gruplandırmanın ve toplu testler çalıştırmanın en kolay yoludur.

2. GET İsteği ile Veri Çekme

API testlerinde en sık kullanılan HTTP metodu GET'tir. GET metodu, sunucudan veri almak için kullanılır.

• Postman arayüzündeki "+" butonuna tıklayarak yeni bir istek sekmesi açın.
• Metod açılır menüsünden GET seçeneğini seçin.
• URL kısmına https://jsonplaceholder.typicode.com/posts/1 yazın.
• "Send" butonuna tıklayın.

İsteği gönderdikten sonra alt kısımda "Response" (Yanıt) alanını göreceksiniz. Burada sunucudan dönen JSON formatındaki veriyi, HTTP durum kodunu (örneğin 200 OK) ve yanıt süresini inceleyebilirsiniz. HTTP 200 OK durumu, isteğin başarılı bir şekilde sunucuya ulaştığını ve talep edilen verinin başarıyla istemciye gönderildiğini gösterir.

3. POST İsteği ile Veri Gönderme

Sunucuya yeni bir veri eklemek veya bir işlem başlatmak için POST metodu kullanılır. Bu metotla birlikte sunucuya genellikle bir veri gövdesi (payload) gönderilir.

• Yeni bir istek açın ve metodu POST olarak değiştirin.
• URL alanına https://jsonplaceholder.typicode.com/posts girin.
• "Body" sekmesine tıklayın, "raw" seçeneğini seçin ve sağdaki açılır menüden "JSON" formatını belirleyin.
• Aşağıdaki örnek JSON verisini gövdeye yapıştırın:

{
  "title": "WebTeknoloji Rehberi",
  "body": "Postman ile API testi içeriği.",
  "userId": 1
}

• "Send" butonuna basın. Başarılı bir işlem sonucunda sunucu genellikle 201 Created durum koduyla birlikte eklenen veriyi geri döndürecektir. HTTP 201 Created kodu, yeni bir kaynağın sunucuda başarıyla oluşturulduğunu doğrular.

4. PUT ve DELETE Metotları ile Güncelleme ve Silme

Var olan bir veriyi tamamen güncellemek için PUT, kısmi güncelleme için PATCH ve veriyi silmek için DELETE metotları kullanılır. Örneğin, https://jsonplaceholder.typicode.com/posts/1 adresine DELETE isteği gönderdiğinizde, sunucudan 200 OK veya 204 No Content durum kodunu almanız gerekir. Bu durum, silme işleminin başarıyla tamamlandığını gösterir.

Postman'de Değişkenler ve Ortam Yönetimi (Environments)

Gerçek dünya projelerinde API'ler genellikle birden fazla sunucu ortamında (yerel geliştirme, test/staging, canlı/production) barındırılır. Her ortam için URL adreslerini ve API anahtarlarını manuel olarak değiştirmek oldukça zahmetlidir. Postman, bu sorunu "Environments" (Ortamlar) ve Değişkenler (Variables) ile çözer.

Bir ortam oluşturarak içerisine base_url adında bir değişken tanımlayabilirsiniz. Örneğin test ortamı için bu değer https://test-api.example.com iken, canlı ortam için https://api.example.com olabilir. İsteklerinizde URL kısmını {{base_url}}/users şeklinde tanımlayarak, sağ üst köşeden seçtiğiniz ortama göre dinamik olarak değişmesini sağlayabilirsiniz. Ayrıca, bir API anahtarını (API Key) tüm isteklerde ayrı ayrı tanımlamak yerine bir global değişken haline getirebilirsiniz. Bu sayede anahtar değiştiğinde sadece tek bir yerden güncelleyerek tüm koleksiyonun sorunsuz çalışmaya devam etmesini sağlarsınız.

Postman ile API Testi Otomasyonu ve Assertion Yazımı

Postman yalnızca manuel istek gönderme aracı değildir; aynı zamanda güçlü bir test otomasyonu aracıdır. İsteklerinizin doğru çalışıp çalışmadığını doğrulamak için "Tests" sekmesini kullanabilirsiniz. Burada JavaScript dilini kullanarak otomatik doğrulama (assertion) senaryoları yazabilirsiniz.

Örneğin, bir GET isteğinden dönen durum kodunun 200 OK olduğunu ve yanıt süresinin 200 milisaniyeden kısa olduğunu doğrulamak için şu kodları kullanabilirsiniz:

pm.test("Durum kodu 200 olmalı", function () {
    pm.response.to.have.status(200);
});

pm.test("Yanıt süresi 200ms altında olmalı", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});

pm.test("Yanıt içeriğinde title kontrolü", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.title).to.not.be.null;
});

Postman'in sunduğu hazır kod şablonları (snippets), JavaScript bilgisi çok az olan kullanıcıların bile hızlıca test yazabilmesini sağlar. Sağ tarafta yer alan panelden "Status code: Code is 200" veya "Response body: JSON value check" gibi şablonlara tıklayarak test kodlarınızı otomatik olarak oluşturabilirsiniz. Bu testleri yazdıktan sonra "Send" butonuna bastığınızda, yanıt alanındaki "Test Results" sekmesinde testlerinizin geçip geçmediğini (PASS/FAIL) yeşil ve kırmızı renklerle görebilirsiniz. Koleksiyonunuzdaki tüm testleri tek tıkla ardışık olarak çalıştırmak için "Collection Runner" özelliğini de kullanabilirsiniz.

API Testlerinde Dikkat Edilmesi Gereken En İyi Pratikler

Başarılı ve sürdürülebilir bir API test süreci yönetmek için şu en iyi pratikleri (best practices) uygulamaya özen gösterin:

• Anlamlı İsimlendirmeler Kullanın: Koleksiyonlarınızı, klasörlerinizi ve isteklerinizi işlevlerine göre net bir şekilde isimlendirin.
• Hata Senaryolarını Atlamayın: Sadece başarılı (2xx) durumları değil, geçersiz parametreler gönderildiğinde API'nin nasıl davrandığını (4xx ve 5xx durum kodları) da test edin.
• Yetkilendirmeyi Dinamik Yapın: Bearer Token veya OAuth 2.0 gibi yetkilendirme yöntemlerini her istek için ayrı ayrı tanımlamak yerine, Koleksiyon seviyesinde (Collection-level Authorization) tanımlayarak alt isteklere miras bırakın.
• CI/CD Entegrasyonu Sağlayın: Postman testlerinizi Newman aracı sayesinde terminal üzerinden çalıştırabilir ve Jenkins, GitHub Actions gibi CI/CD süreçlerinize dahil ederek sürekli entegrasyon sağlayabilirsiniz.