Postman ile API Testi Eğitimi

Eğitim Hakkında

Postman ile API testi: koleksiyonlar, pm.test betikleri, veri güdümlü çalıştırma ve Newman CI

Bu eğitim, Postman ile API test sürecini manuel keşiften CI entegrasyonuna kadar öğretir. Koleksiyon ve klasör yapısı, ortam ve koleksiyon değişkenleri, pre-request script, Bearer ve OAuth 2.0 kimlik doğrulama, pm.test ve pm.expect ile durum kodu, süre ve JSON alan doğrulaması, istekler arası veri aktarımı, JSON şema doğrulama, Collection Runner ile CSV veri güdümlü test ve negatif senaryolar işlenir. Newman, htmlextra raporu, GitHub Actions entegrasyonu, mock server ve monitör de uygulanır.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar Postman ile İlk Testler → Test Otomasyonu ve CI sırasıyla ilerler.

Seviye

Temel Seviye — Postman ile API testi: koleksiyonlar, pm.test betikleri, veri güdümlü çalıştırma ve Newman CI.

Öğrenme Metodu

Katılımcılar demo bir REST API için Postman koleksiyonu hazırlar, test betikleri yazar ve Newman ile CI hattında çalıştırır.

Neden Bu Eğitim?

📬Koleksiyon Disiplini

Düzenli, ortam bağımsız ve paylaşılabilir bir Postman çalışma alanı kurarsınız.

✅Otomatik Doğrulama

Her isteğe anlamlı doğrulamalar yazarak regresyonları anında yakalarsınız.

🤖CI Entegrasyonu

Newman ile testleri her commit'te çalışan bir hatta bağlarsınız.

Anahtar Konular

PostmanPostman ile API testipm.testNewmanCollection RunnerPostman mock serverAPI test otomasyonuPostman ortam değişkenleriPostman eğitimiAPI testi

“Test edilmeyen API, kullanıcıya sorulmamış bir sorudur.”

Ön Koşullar

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

1

HTTP Temel Bilgisi

URL, istek ve yanıt kavramlarına genel aşinalık yeterlidir.

2

Programlama Deneyimi

Herhangi bir dilde temel değişken, fonksiyon ve JSON okuma becerisi beklenir.

3

Kurulu Araçlar

Postman veya curl ile bir kod düzenleyici (VS Code / IntelliJ) kurulu olmalıdır.

4

Çalışma Ortamı

İnternet erişimli, yönetici izni olan ve en az 8 GB RAM'li bir dizüstü bilgisayar 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ı HTTP istek ve yanıt yapısını curl ile satır satır inceler, Postman koleksiyonu, ortam değişkeni ve kimlik doğrulama ayarlarını yapılandırır, GET, POST, PUT, PATCH ve DELETE metotlarını güvenlik ve idempotency açısından ayırır ve HTTP durum kodlarını seçer ve RFC 7807 Problem Details ile hata yanıtı tasarlar.

Modül 1

HTTP Protokolü ve İstek/Yanıt Yapısı

İstek satırı, başlıklar ve gövde: Host, Accept, Content-Type, Content-Length ve User-Agent alanlarının rolü
HTTP/1.1, HTTP/2 ve HTTP/3 farkları: keep-alive, çoklama (multiplexing) ve başlık sıkıştırma (HPACK)
TLS el sıkışması, sertifika zinciri ve curl -v ile bağlantı kurulumunun adım adım izlenmesi
Önbellek başlıkları: Cache-Control, ETag, If-None-Match ve 304 Not Modified akışı
Çerez, Authorization ve CORS ön uçuş (preflight OPTIONS) isteklerinin tarayıcıdaki davranışı
URL anatomisi: şema, host, port, path, query string ve yüzde kodlama (percent-encoding) kuralları

Modül 2

Postman Koleksiyonları ve Ortam Yönetimi

Çalışma alanı, koleksiyon, klasör ve istek hiyerarşisi ile adlandırma düzeni
Ortam (environment), global ve koleksiyon değişkenleri: {{baseUrl}} ve kapsam öncelik sırası
Authorization sekmesi: Bearer, OAuth 2.0 token alma akışı ve koleksiyon düzeyinde kalıtım
Pre-request script ile dinamik değişken, zaman damgası ve HMAC imzası üretme
OpenAPI dosyasından koleksiyon içe aktarma ve Postman API Network kullanımı
Koleksiyon dokümantasyonu yayınlama ve takım çalışma alanında sürüm/çatallama (fork) akışı

Modül 3

HTTP Metotları ve Idempotency

GET, HEAD, OPTIONS metotlarının güvenli (safe) olması ve PUT, DELETE metotlarının idempotent olması
POST ile PUT arasındaki fark: kaynak oluşturma, tam değiştirme ve 201 Created ile Location başlığı
PATCH ile kısmi güncelleme: JSON Merge Patch (RFC 7396) ve JSON Patch (RFC 6902) karşılaştırması
Idempotency-Key başlığı ile ödeme gibi kritik POST isteklerinin tekrar güvenli hale getirilmesi
Koşullu istekler: If-Match ve ETag ile iyimser eşzamanlılık (optimistic concurrency) kontrolü
Metot override (X-HTTP-Method-Override) ve OPTIONS ile Allow başlığının keşif amaçlı kullanımı

Modül 4

Durum Kodları ve Hata Modelleri

2xx, 3xx, 4xx, 5xx sınıfları: 200, 201, 202, 204, 301, 304, 400, 401, 403, 404, 409, 422, 429, 500, 503 ayrımı
401 Unauthenticated ile 403 Forbidden arasındaki fark ve WWW-Authenticate başlığı
400 ile 422 arasında doğrulama hatası kararı ve alan bazlı hata listesi döndürme
RFC 7807 application/problem+json biçimi: type, title, status, detail ve instance alanları
Retry-After, 429 Too Many Requests ve 503 durumlarında istemci tarafı yeniden deneme davranışı
Hata yanıtlarında yığın izi sızıntısı ve hassas bilgi ifşasını önleme kuralları

Günün hedefiKatılımcı pm.test ve pm.expect ile otomatik doğrulama yazar, koleksiyonu veri dosyasıyla çalıştırır, Newman ile koleksiyonları CI hattında çalıştırır, mock server ve monitör kurar, API kimlik doğrulama yöntemlerini, JWT yapısını ve OWASP API Top 10 risklerini ele alır ve OpenAPI 3 tanımı yazar, Swagger UI ve kod üreticilerle sözleşme öncelikli çalışır.

Modül 1

Postman Test Betikleri ve Collection Runner

pm.test ve pm.expect (Chai) ile durum kodu, süre, başlık ve JSON alan doğrulamaları
pm.response.json() ile yanıttan veri çekip pm.environment.set ile sonraki isteğe aktarma (zincirleme)
tv4 / Ajv ile JSON şema doğrulaması ve ortak test kütüphanesi paylaşımı
Collection Runner ile CSV/JSON veri dosyası kullanarak veri güdümlü (data-driven) test
postman.setNextRequest ile akış kontrolü ve koşullu istek sıralama
Negatif test senaryoları: eksik alan, geçersiz token, aşırı büyük gövde ve beklenen 4xx doğrulaması

Modül 2

Newman, CI/CD ve Mock Server

Newman kurulumu ve newman run komutu: -e, -d, --iteration-count, --bail seçenekleri
htmlextra ve JUnit raporlayıcıları ile test sonuçlarının üretilmesi
GitHub Actions veya Jenkins hattına Newman adımı ekleme ve başarısız testte derlemeyi durdurma
Postman Mock Server ile örnek yanıtlardan sahte servis oluşturma
Postman Monitors ile zamanlanmış kontrol ve uyarı yapılandırması
Gizli bilgilerin (API anahtarı) CI ortam değişkeni veya vault ile koleksiyona verilmesi

Modül 3

API Güvenliği: OAuth 2.0, JWT ve Oran Sınırlama

API anahtarı, Basic Auth, Bearer token ve OAuth 2.0 akışları: authorization code (PKCE), client credentials
JWT yapısı: header, payload, imza, exp/iat/aud talepleri ve RS256 ile HS256 farkı
Scope ve rol tabanlı yetkilendirme ile nesne düzeyi yetki kontrolü (BOLA) açığı örneği
OWASP API Security Top 10: aşırı veri ifşası, mass assignment ve bozuk kimlik doğrulama
Oran sınırlama (rate limiting) algoritmaları: token bucket, sliding window ve 429 yanıtı
CORS yapılandırması, girdi doğrulama ve TLS zorunluluğu (HSTS) ile temel sertleştirme

Modül 4

OpenAPI ile Sözleşme Öncelikli Tasarım

OpenAPI 3.0 belge yapısı: info, servers, paths, components, schemas ve securitySchemes
JSON Schema ile nesne modelleme: required, enum, oneOf, allOf ve $ref ile yeniden kullanım
Swagger Editor ve Swagger UI ile etkileşimli dokümantasyon yayınlama
openapi-generator ile istemci SDK ve sunucu iskeleti üretimi
Spectral ile OpenAPI lint kuralları ve CI hattında sözleşme doğrulama
Örnek (example) ve yanıt şeması ile mock sunucu (Prism) üzerinden tüketici ekiple paralel çalışma

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

HTTP Yapısı

HTTP istek satırı, başlıkları ve gövdesini okuyup hata ayıklayabilirsiniz.

🧩

Postman Koleksiyon

Koleksiyon, klasör ve ortam değişkenleriyle düzenli bir Postman çalışma alanı kurabilirsiniz.

🛠️

HTTP Metotları

Metotları güvenli ve idempotent olma özelliklerine göre doğru senaryoda kullanabilirsiniz.

🔐

Hata Modeli

Doğru HTTP durum kodlarını seçip RFC 7807 uyumlu hata yanıtları tasarlayabilirsiniz.

📈

Postman Testleri

pm.test betikleriyle yanıtları otomatik doğrulayıp veri güdümlü koleksiyon çalıştırabilirsiniz.

🧪

Newman ve CI

Newman ile Postman testlerini CI hattında raporlu şekilde çalıştırabilirsiniz.

🚀

API Güvenliği

OAuth 2.0 ve JWT ile korunan API akışlarını kurup yaygın OWASP API risklerini kapatabilirsiniz.

🔎

OpenAPI

OpenAPI 3 tanımı yazıp Swagger UI ve kod üretimiyle sözleşme öncelikli geliştirebilirsiniz.

Kimler İçin Uygundur?

Test mühendisleri
QA analistleri
API tüketen geliştiriciler
manuel testten otomasyona geçmek isteyen profesyoneller için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Test mühendisleri, QA analistleri, API tüketen geliştiriciler ve manuel testten otomasyona geçmek isteyen profesyoneller için uygundur.

Postman ücretsiz sürümle yapılabilir mi?

Evet, eğitimdeki tüm uygulamalar ücretsiz hesapla yapılabilir.

JavaScript şart mı?

Temel JavaScript örneklerle öğretilir, derin bilgi gerekmez.

Newman CI'da nasıl çalıştırılır?

GitHub Actions örneğiyle Newman adımı eklenir ve başarısız testte derleme durdurulur.

Eğitim sonunda sertifika verilir mi?

Eğitimi tamamlayan katılımcılara Digital Vizyon Akademi Katılım ve Başarı Sertifikası verilir. Üçüncü taraf kurumların sınav ve sertifikalarıyla bir bağı yoktur.

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

POSTMAN İLE API TESTİ EĞİTİMİ