Postman ile API Sözleşme Testi

Eğitim Hakkında

Postman'da API sözleşme testi pratiği

Eğitim Postman ile API sözleşme testinin kurulmasını anlatır. Koleksiyon ve değişken yapısı, pm.test ile durum kodu ve başlık doğrulaması, JSON Schema ile zorunlu alan ve tip kontrolü, OpenAPI şemasına karşı yanıt doğrulama, Pact ile tüketici güdümlü sözleşmeyle karşılaştırma, Newman ile CI'da sürüm kapısı, Monitor ile zamanlı koşum uygulamalı işlenir.

Süre ve Format

2 Gün. Her gün dört modül; 1. gün Postman Testleri ve Sözleşme Doğrulama; 2. gün Sözleşme Testi, Veri ve İzleme.

Seviye

Orta Seviye — Postman'da API sözleşme testi pratiği

Öğrenme Metodu

Her konu Postman üzerinde canlı bir örnek API'ye karşı uygulanır; katılımcılar kendi koleksiyonlarını kurar, test betiklerini yazar ve Newman ile komut satırından çalıştırır.

Neden Bu Eğitim?

🧪Otomatik Doğrulama

Elle kontrol yerine tekrar çalıştırılabilir test betikleriyle API'leri doğrularsınız.

🔗Gerçekçi Senaryolar

Birbirine bağlı isteklerle gerçek kullanıcı akışlarını test etmeyi öğrenirsiniz.

⚙️CI Entegrasyonu

Newman ile testlerinizi derleme hattına taşıyıp sürekli doğrulama sağlarsınız.

Anahtar Konular

postmanapi testipostman eğitiminewmanapi test otomasyonupm.testcollection runnerrest api testapi contract & automation testing with postman: contract testing

“Sözleşme, iki ekibin ortak sözüdür.”

Ön Koşullar

Eğitimden verim almak için faydalı olacak bilgi ve ortam gereksinimleri

1

API Farkındalığı

REST API ve JSON'un ne olduğuna dair temel fikir yeterlidir.

2

JavaScript Temeli

Test betikleri için değişken, koşul ve fonksiyon düzeyinde JavaScript bilgisi faydalıdır.

3

Araçlar

Postman masaüstü uygulaması ve Node.js (Newman için) kurulu olmalıdır.

4

İnternet Erişimi

Örnek genel API'lere bağlanabilen bir ağ ortamı gerekir.

Eğitim İçeriği

Programın gün gün akışı aşağıdadır. Bir güne tıklayarak o günün modüllerini ve içeriklerini görebilirsiniz.

Günün hedefiKatılımcı gün sonunda Postman Arayüzü ve İlk İstekler konusunu çalıştırır, Postman Test Betikleri ve Doğrulamalar ve Postman Değişkenleri ve Ortamlar ile ilerleyip OpenAPI ile Sözleşme ve Dokümantasyon kararlarını gerekçelendirir.

Modül 1

Postman Arayüzü ve İlk İstekler

Workspace, collection, folder ve request hiyerarşisi
GET, POST, PUT, DELETE istekleri; params, headers, body (raw JSON, form-data, x-www-form-urlencoded)
Yanıt panelinde Body, Cookies, Headers, Test Results ve süre / boyut bilgisi
Authorization sekmesi: API Key, Bearer Token, Basic Auth, OAuth 2.0
Postman Console ile istek / yanıt ayrıntılarının hata ayıklaması
Collection'ı dışa aktarma, içe aktarma ve ekip workspace'inde paylaşma

Modül 2

Postman Test Betikleri ve Doğrulamalar

pm.test ve pm.expect (Chai) ile durum kodu, süre ve başlık doğrulamaları
pm.response.json() ile gövde alanı doğrulama ve JSON Schema (tv4/Ajv) kontrolü
Pre-request script ile dinamik veri, zaman damgası ve imza üretimi
Collection, folder ve request seviyesinde script kapsamı ve çalışma sırası
postman.setNextRequest ve pm.execution.setNextRequest ile akış kontrolü
Test sonuçlarında başarısızlık analizi ve flaky testlerin ayıklanması

Modül 3

Postman Değişkenleri ve Ortamlar

Değişken kapsamları: global, collection, environment, data, local ve öncelik sırası
{{değişken}} sözdizimi ve pm.variables, pm.environment, pm.collectionVariables API'leri
Dev, test ve prod için ayrı environment'lar ile baseUrl yönetimi
Login yanıtından token çıkarıp sonraki isteklere otomatik taşıma
Initial value ile current value farkı ve gizli (secret) değişkenlerin korunması
Dinamik değişkenler: {{$guid}}, {{$timestamp}}, {{$randomInt}}

Modül 4

OpenAPI ile Sözleşme ve Dokümantasyon

OpenAPI 3.x yapısı: paths, components, schemas, parameters, responses
$ref ile yeniden kullanım, allOf / oneOf ve discriminator
securitySchemes: apiKey, http bearer, oauth2 ve openIdConnect
Swagger Editor ve Stoplight ile tasarım, Spectral ile kural tabanlı lint
openapi-generator ile sunucu iskeleti ve istemci SDK'sı üretimi
Örnek (example) alanları ve Redoc ile geliştirici dokümanı yayınlama

Günün hedefiKatılımcı API Sözleşme Testi ve Veri Dosyaları ve Collection Runner konularını uygulayarak BDD ve Sözleşme Testleri ile Postman Monitör, Fork ve Ekip Çalışması adımlarını aynı örnek üzerinde birleştirir.

Modül 1

API Sözleşme Testi

Sözleşme testi kavramı: sağlayıcı (provider) ve tüketici (consumer) beklentileri
OpenAPI şemasını Postman'a bağlayıp yanıt doğrulaması yapma
JSON Schema ile zorunlu alan, tip ve enum kontrolü
Geriye dönük uyumluluk bozan değişikliklerin tespiti
Pact ile tüketici güdümlü sözleşme testlerine karşılaştırma
Sözleşme testlerini CI hattına bağlayıp sürüm kapısı olarak kullanma

Modül 2

Veri Dosyaları ve Collection Runner

Collection Runner ile iterasyon, gecikme ve çalışma sırası ayarı
CSV ve JSON veri dosyalarıyla veri güdümlü (data-driven) test
Veri dosyasındaki beklenen değerleri iteration data ile karşılaştırma
Newman ile komut satırı koşumu ve htmlextra / junit raporlayıcıları
Jenkins veya GitHub Actions içinde Newman çalıştırma
Çalışma sonuçlarının yorumlanması ve başarısızlıkların yeniden üretilmesi

Modül 3

BDD ve Sözleşme Testleri

Gherkin: Given-When-Then yapısı ve ortak dil
Cucumber ile feature dosyası ve step definition yazımı
Spring Cloud Contract ve Pact ile tüketici güdümlü sözleşme
WireMock ile bağımlı servis davranışı taklidi
CI hattında test aşamaları: birim, entegrasyon, sözleşme, smoke
Flaky test nedenleri ve kararlı hale getirme teknikleri

Modül 4

Postman Monitör, Fork ve Ekip Çalışması

Monitor ile zamanlanmış koleksiyon çalıştırma ve e-posta uyarıları
Fork, pull request ve sürüm geçmişi ile ekip içi birlikte çalışma
Rol bazlı workspace erişimi ve API Network yayını
Collection'dan otomatik doküman üretimi ve yayımlama
Postman API ile koleksiyonların programatik yönetimi
Test ve ortam sırlarının vault ile güvenli yönetimi

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

Postman Kullanımı

Postman'da koleksiyon oluşturup farklı kimlik doğrulama yöntemleriyle istek gönderebilirsiniz.

🧩

Postman Testleri

pm.test ile durum kodu, başlık ve gövde doğrulayan otomatik testler yazabilirsiniz.

🔧

Değişken Yönetimi

Değişken kapsamlarını ve ortam yapılarını kullanarak yeniden kullanılabilir Postman koleksiyonları kurabilirsiniz.

📐

OpenAPI Sözleşmesi

OpenAPI ile makine okunur API sözleşmesi yazıp kod ve doküman üretebilirsiniz.

🛡️

Sözleşme Testi

API yanıtlarının sözleşmeyle uyumunu otomatik doğrulayan testler yazabilirsiniz.

🧪

Veri Güdümlü Test

CSV/JSON veri dosyalarıyla Collection Runner ve Newman üzerinden toplu test koşabilirsiniz.

🚀

BDD ve Sözleşme

Gherkin senaryoları ve sözleşme testleriyle API'ler arası uyumu otomatik doğrulayabilirsiniz.

📊

Ekip Çalışması

Postman monitörleri ve ekip workspace'leriyle test süreçlerini ortak yönetebilirsiniz.

Kimler İçin Uygundur?

Test mühendisleri
API geliştiricileri
entegrasyon ekipleri için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Test mühendisleri, API geliştiricileri ve entegrasyon ekipleri için uygundur.

Kod bilmeden katılabilir miyim?

Evet; başlangıçta arayüz üzerinden ilerlenir, test betikleri için gereken JavaScript parçaları adım adım örneklenir.

Ücretli Postman hesabı gerekli mi?

Ücretsiz hesap temel konular için yeterlidir; bazı ekip özellikleri için plan gerekebileceği eğitimde belirtilir.

Newman ve CI konuları işleniyor mu?

Evet; koleksiyonların Newman ile komut satırından ve CI hattında çalıştırılması uygulamalı gösterilir.

Sertifika veriliyor mu?

Tamamlayan katılımcılara Digital Vizyon Akademi Katılım ve Başarı Sertifikası verilir.

Sertifikalandırma

Bu eğitim Digital Vizyon Akademi Başarı Sertifikası ile tamamlanır.

Eğitim başında “Ön Test”, bitiminde “Son Test” uygulanarak gelişim ölçümlenir. Değerlendirme formunu dolduran katılımcılar sertifikalarını alır. Sertifikanızın geçerliliğini Sertifika Sorgulama sayfasından doğrulayabilirsiniz.

Örnek Sertifika

API CONTRACT & AUTOMATION TESTING WITH POSTMAN: CONTRACT TESTING EĞİTİMİ