REST Assured ile API Testine Başlangıç

Eğitim Hakkında

REST Assured ile API test otomasyonuna giriş: given/when/then, Hamcrest, JSON doğrulama ve raporlama

Bu eğitim, Java ile API test otomasyonuna REST Assured kullanarak başlamak isteyenler için hazırlanmıştır. HTTP ve REST temelleri, Maven bağımlılıkları, JUnit 5, given/when/then söz dizimi, baseURI ve basePath, path ve query parametreleri, POST gövdesi ve POJO serileştirme, Basic ve Bearer kimlik doğrulama işlenir. Hamcrest eşleştiricileri, GPath ile JSON alan doğrulama, log().ifValidationFails(), hata ayıklama ve Allure ile rapor üretimi uygulanır.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar REST Assured'a Giriş → Doğrulama ve Raporlama sırasıyla ilerler.

Seviye

Temel Seviye — REST Assured ile API test otomasyonuna giriş: given/when/then, Hamcrest, JSON doğrulama ve raporlama.

Öğrenme Metodu

Katılımcılar IntelliJ'de herkese açık bir test API'sine karşı REST Assured testleri yazar, çalıştırır ve Allure raporu üretir.

Neden Bu Eğitim?

🚀Hızlı Başlangıç

Maven projesini kurup ilk REST Assured testini kısa sürede çalıştırırsınız.

📖Okunur Testler

BDD tarzı given/when/then ile anlaşılır testler yazarsınız.

📊Raporlu Sonuç

Allure ile paydaşlara gösterilebilir test raporu üretirsiniz.

Anahtar Konular

REST AssuredREST Assured eğitimiAPI test otomasyonuJava API testiHamcrestgiven when thenJUnit 5 APIJSONPathAllure raporREST Assured başlangıç

“İlk otomatik test, bir sonrakinin yazılmasını kolaylaştıran en önemli adımdır.”

Ön Koşullar

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

1

Java Temelleri

Sınıf, metot, koleksiyon ve generics konularında temel Java bilgisi gerekir.

2

HTTP ve JSON

HTTP metotları, durum kodları ve JSON yapısına aşinalık beklenir.

3

Maven ve IDE

Maven bağımlılık yönetimi ve IntelliJ IDEA veya Eclipse kullanımına genel hakimiyet faydalıdır.

4

Çalışma Ortamı

JDK 17+, Maven ve internet erişimi olan bir dizüstü bilgisayar hazır bulunmalıdır.

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, REST kısıtlarını ve Richardson olgunluk modelini örneklerle açıklar, REST Assured projesini Maven ile kurar ve given/when/then kalıbıyla ilk testleri yazar ve Sorgu/yol parametreli, gövdeli ve kimlik doğrulamalı uç noktaları REST Assured ile test eder.

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

REST Mimari Kısıtları ve Kaynak Modeli

Roy Fielding tezindeki altı kısıt: istemci-sunucu, durumsuzluk, önbellek, tektip arayüz, katmanlı sistem, isteğe bağlı kod
Richardson olgunluk modeli: Seviye 0 (RPC) ile Seviye 3 (HATEOAS) arasındaki farkın örnekle gösterilmesi
Kaynak (resource) ile temsil (representation) ayrımı ve URI ile kaynak kimliklendirme
Durumsuzluğun oturum yönetimi, ölçeklenme ve yük dengeleme üzerindeki etkisi
REST, SOAP, gRPC ve GraphQL karşılaştırması: hangi senaryoda hangisi seçilir
Gerçek bir genel API (GitHub, Stripe veya OpenWeather) üzerinde REST uyumluluk denetimi

Modül 3

REST Assured ile İlk Testler

Maven bağımlılıkları: rest-assured, JUnit 5 veya TestNG ve hedef Java sürümü yapılandırması
given() / when() / then() söz dizimi ve BDD tarzı okunabilir test cümleleri
RestAssured.baseURI, basePath ve port ayarlarıyla ortama göre hedef belirleme
GET isteğiyle durum kodu, Content-Type ve gövdeden alan okuma (extract().path())
log().all(), log().ifValidationFails() ile istek ve yanıtın günlüklenmesi
Test API'si olarak JSON Server veya ReqRes kullanımı ve ilk test sınıfının çalıştırılması

Modül 4

REST Assured ile Farklı HTTP Uç Noktalarını Test Etme

pathParam, queryParam, formParam ve header ile istek parametrelerinin gönderilmesi
POST/PUT/PATCH gövdesini Map, JSON dizesi ve POJO (Jackson serileştirme) ile gönderme
DELETE ve idempotency doğrulaması: aynı isteği iki kez gönderip sonuçları karşılaştırma
Basic, preemptive basic, OAuth 2.0 Bearer ve API anahtarı ile kimlik doğrulama (auth())
multipart/form-data dosya yükleme, cookie yönetimi ve yönlendirme (redirect) davranışı
XML yanıtları için XmlPath ve içerik tipine göre ayrıştırıcı (parser) seçimi

Günün hedefiKatılımcı Hamcrest ve Matchers ile koleksiyon, metin ve sayısal doğrulamalar yazar, GPath ile JSON ayrıştırır ve JSON Schema Validator ile şema doğrular, Tarayıcı geliştirici araçları, curl, Fiddler ve mitmproxy ile API trafiğini inceler ve REST Assured testlerini Allure ve ExtentReports ile raporlar, CI hattına bağlar.

Modül 1

Hamcrest Eşleştiricileri ile Yanıt Doğrulama

equalTo, not, nullValue, notNullValue ve is() ile temel eşleştiriciler
hasItem, hasItems, hasSize, containsInAnyOrder, everyItem ile liste doğrulamaları
startsWith, containsString, matchesPattern ile metin ve düzenli ifade doğrulaması
greaterThan, lessThanOrEqualTo, closeTo ile sayısal ve ondalık aralık kontrolleri
allOf, anyOf ve özel (custom) TypeSafeMatcher yazarak yeniden kullanılabilir doğrulama
Doğrulama başarısızlık mesajlarını okuma ve anlamlı hata açıklaması üretme

Modül 2

JSON Yanıt ve Şema Doğrulama

JsonPath / GPath ifadeleri: data.items[0].id, findAll, collect, sum, max
İç içe dizilerde filtreleme: items.findAll { it.price > 100 }.name
json-schema-validator modülü ile matchesJsonSchemaInClasspath kullanımı
JSON Schema Draft-07 anahtarları: required, type, format, additionalProperties, minItems
Yanıtı POJO'ya eşleme (as(Class)) ve nesne düzeyinde assertJ doğrulaması
Şema sürüm değişikliğinde kırıcı değişiklikleri yakalayan sözleşme testi stratejisi

Modül 3

Web API Keşfi ve Hata Ayıklama Araçları

Tarayıcı DevTools Network sekmesi: zamanlama (waterfall), başlık ve yük inceleme, HAR dışa aktarımı
curl ile -X, -H, -d, -i, -w ve --trace seçenekleriyle istek oluşturma ve gecikme ölçme
Fiddler Everywhere veya mitmproxy ile HTTPS trafiğini araya girerek inceleme ve istek değiştirme
HTTPie ve jq ile komut satırından JSON yanıtlarını biçimlendirme ve süzme
Yaygın sorun sınıfları: CORS hataları, yanlış Content-Type, sıkıştırma ve yönlendirme döngüleri
Sunucu tarafı erişim günlükleri, correlation ID ve istek izleme ile uçtan uca hata takibi

Modül 4

Allure ve ExtentReports ile Test Raporlama

Allure ile @Step, @Feature, @Story ek açıklamaları ve AllureRestAssured filtresi
Allure sonuç dizini (allure-results), allure serve ve trend/geçmiş grafikleri
ExtentReports ile HTML rapor, test kategorileri ve hata ekran/yük ekleme
Surefire/Failsafe raporları ve JUnit XML çıktısının CI araçlarında okunması
Jenkins veya GitHub Actions üzerinde rapor yayınlama (artifact, Pages) ve Slack bildirimi
Hatalı testlerde istek/yanıt günlüğünün rapora eklenmesi ve gizli bilgilerin maskelenmesi

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.

🧩

REST Kısıtları

REST kısıtlarını ve Richardson olgunluk seviyelerini bir API üzerinde değerlendirebilirsiniz.

🛠️

REST Assured Başlangıç

given/when/then kalıbıyla çalışan ilk REST Assured testlerini yazıp çalıştırabilirsiniz.

🔐

HTTP Uç Nokta Testi

Parametreli, gövdeli ve yetkilendirmeli uç noktalar için REST Assured testleri yazabilirsiniz.

📈

Hamcrest Doğrulama

Hamcrest eşleştiricileriyle koleksiyon ve metin doğrulamalarını okunabilir biçimde yazabilirsiniz.

🧪

JSON ve Şema

GPath ile JSON alanlarını doğrulayıp JSON Schema ile sözleşme testi yazabilirsiniz.

🚀

API Hata Ayıklama

curl, tarayıcı DevTools ve proxy araçlarıyla API sorunlarının kaynağını bulabilirsiniz.

🔎

Test Raporlama

Allure veya ExtentReports ile istek/yanıt detaylı test raporları üretip CI'da yayınlayabilirsiniz.

Kimler İçin Uygundur?

Manuel testten API otomasyonuna geçen QA mühendisleri
Java bilen test uzmanları
backend geliştiriciler için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Manuel testten API otomasyonuna geçen QA mühendisleri, Java bilen test uzmanları ve backend geliştiriciler için uygundur.

Java bilgisi şart mı?

Temel Java (sınıf, metot, koleksiyon) bilgisi gerekir; test çatısı eğitimde anlatılır.

JUnit mi TestNG mi kullanılır?

JUnit 5 ile çalışılır; TestNG farkları kısaca belirtilir.

Postman bilgisi gerekli mi?

Hayır, ancak Postman ile temel karşılaştırma yapılır.

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

REST ASSURED API TESTING: GETTING STARTED WITH REST ASSURED TESTING EĞİTİMİ