REST Assured: JSON Yanıt ve Şema Doğrulama

Eğitim Hakkında

REST Assured ile JSON yanıt ve JSON Schema doğrulaması: GPath, şema validator, POJO ve sözleşme testi

Bu eğitim, REST Assured ile JSON yanıtlarının içerik ve yapı doğrulamasını derinlemesine ele alır. JSON veri tipleri ve ISO 8601, GPath ile findAll, collect, sum ve max, iç içe dizilerde filtreleme, json-schema-validator ile matchesJsonSchemaInClasspath, Draft-07 anahtarları (required, type, format, additionalProperties), POJO eşleme ve OpenAPI belgesinden şema türetme, Pact ve sözleşme testi stratejisi ile şema sürümü değişikliklerinde kırıcı değişikliklerin yakalanması uygulanır.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar JSON İçerik Doğrulama → Şema, Sözleşme ve Test Yapısı sırasıyla ilerler.

Seviye

Orta Seviye — REST Assured ile JSON yanıt ve JSON Schema doğrulaması: GPath, şema validator, POJO ve sözleşme testi.

Öğrenme Metodu

Katılımcılar örnek API için JSON Schema dosyaları yazar, şemayı bozan değişiklikleri testle yakalar ve OpenAPI belgesinden doğrulama üretir.

Neden Bu Eğitim?

📐Şema Güvencesi

API yanıt yapısının sessizce bozulmasını şema testleriyle engellersiniz.

🔍Derin JSON Sorgusu

GPath ile karmaşık iç içe verileri tek satırda doğrularsınız.

🤝Sözleşme Disiplini

Tüketicilerle yapılan sözleşmeyi otomatik test ederek korursunuz.

Anahtar Konular

JSON SchemaREST Assured JSONGPathjson-schema-validatorJSON doğrulamasözleşme testiOpenAPIPOJOAPI testREST Assured eğitimi

“Şema, API'nin kendisine verdiği sözdür; test onu hatırlatı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ı Accept/Content-Type ile içerik pazarlığı yapar ve JSON ile XML serileştirmesini karşılaştırır, REST Assured projesini Maven ile kurar ve given/when/then kalıbıyla ilk testleri yazar, GPath ile JSON ayrıştırır ve JSON Schema Validator ile şema doğrular ve OpenAPI 3 tanımı yazar, Swagger UI ve kod üreticilerle sözleşme öncelikli çalışır.

Modül 1

İçerik Pazarlığı, JSON ve XML Formatları

Accept ve Content-Type başlıkları, 406 Not Acceptable ve 415 Unsupported Media Type yanıtları
JSON veri tipleri, iç içe nesneler, null yönetimi ve tarih/saat için ISO 8601 biçimi
XML ad alanları, öznitelik-eleman ayrımı ve JSON ile XML arasında dönüşüm tuzakları
Jackson, Gson veya System.Text.Json gibi serileştiricilerde özel formatter yapılandırması
Accept-Language ve Accept-Encoding ile yerelleştirme ve gzip/brotli sıkıştırma
application/vnd.firma.v2+json gibi vendor media type ile sürüm yönetimi

Modül 2

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 3

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 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

Günün hedefiKatılımcı Hamcrest ve Matchers ile koleksiyon, metin ve sayısal doğrulamalar yazar, Sorgu/yol parametreli, gövdeli ve kimlik doğrulamalı uç noktaları REST Assured ile test eder, RequestSpecification, ResponseSpecification ve katmanlı test çatısı tasarlar ve Test piramidi, tüketici güdümlü sözleşme testi (Pact) ve Testcontainers ile test yazar.

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

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

Modül 3

REST Assured Test Mimarisi ve Yapılandırma

RequestSpecBuilder ve ResponseSpecBuilder ile ortak başlık, taban URL ve beklentilerin merkezi tanımı
Page Object benzeri API istemci sınıfları (service object) ve test verisi oluşturucular (builder)
Ortam yapılandırması: properties/YAML dosyaları, Maven profilleri ve sistem özellikleri
Filter arayüzü ile istek/yanıt kesme, token yenileme ve özel günlükleme
Test verisi yönetimi: @BeforeAll/@AfterEach ile oluştur-sil döngüsü ve bağımsız testler
Paralel çalıştırma, JUnit 5 etiketleri (tag) ve duman/regresyon paketlerinin ayrıştırılması

Modül 4

Mikroservis Test Stratejisi

Mikroservis test piramidi: birim, bileşen, entegrasyon, sözleşme ve uçtan uca testler
Tüketici güdümlü sözleşme testi: Pact ile consumer test ve provider doğrulama
Testcontainers ile gerçek PostgreSQL, Kafka ve Redis kullanan entegrasyon testleri
WireMock ve Spring Cloud Contract ile bağımlı servislerin taklit edilmesi
Üretimde test: canary, gölge (shadow) trafik ve özellik bayraklarıyla güvenli yayın
Kararsız (flaky) test nedenleri ve asenkron akışların Awaitility ile test edilmesi

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

İçerik Formatları

JSON ve XML temsillerini içerik pazarlığı ile aynı uç noktadan sunabilirsiniz.

🧩

REST Assured Başlangıç

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

🛠️

JSON ve Şema

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

🔐

OpenAPI

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

📈

Hamcrest Doğrulama

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

🧪

HTTP Uç Nokta Testi

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

🚀

Test Mimarisi

Yeniden kullanılabilir spesifikasyonlarla bakımı kolay bir API test çatısı kurabilirsiniz.

🔎

Test Stratejisi

Birim, sözleşme ve uçtan uca testleri dengeli bir mikroservis test stratejisine yerleştirebilirsiniz.

Kimler İçin Uygundur?

REST Assured bilen QA mühendisleri
API sözleşmesinin korunmasından sorumlu geliştiriciler
test mimarları için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

REST Assured bilen QA mühendisleri, API sözleşmesinin korunmasından sorumlu geliştiriciler ve test mimarları için uygundur.

JSON Schema hangi sürümü kullanılıyor?

Draft-07 ağırlıklı kullanılır; yeni sürümlerdeki farklara değinilir.

Şemayı elle mi yazıyoruz?

İki yol da gösterilir: elle yazım ve örnek JSON veya OpenAPI belgesinden üretim.

Pact ele alınıyor mu?

Tüketici güdümlü sözleşme testi kavramsal olarak ve kısa uygulama ile gösterilir.

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: VALIDATING JSON RESPONSES & SCHEMAS EĞİTİMİ