F3 · Swagger UI "Try it out": ilk elle: Swagger UI, spec dosyasından otomatik oluşan bir **showroom**dur: bir araba showroom'unda arabanın teknik özelliklerini kağıttan okumak ye
Swagger UI, spec dosyasından otomatik oluşan bir **showroom**dur: bir araba showroom'unda arabanın teknik özelliklerini kağıttan okumak yerine direksiyona oturup gaza basabilirsin — Swagger UI de spec'teki her endpoint'i "Try it out" butonuyla GERÇEKTEN çağırmana izin verir, hiçbir kod yazmadan, hiçbir Postman kurulumu olmadan. Peki Postman zaten varken bu neden ayrı bir araç? Çünkü Swagger UI, spec'in kendisinden DOĞAR — Postman'de bir request'i elle kurman gerekirken (endpoint'i, alanları biliyor olman gerekir), Swagger UI spec'i okuyup SANA formu otomatik hazırlar: hangi alanın zorunlu olduğunu, hangi değerlerin geçerli olduğunu (enum) ÖNCEDEN gösterir. Java'da bunun karşılığı bir REPL (`jshell`) gibidir — kodu derleyip paketlemeden, doğrudan DENEYEBİLDİĞİN bir ortam. QA açısından Swagger UI, bir API'yi ilk kez gören bir testerın "önce anla, sonra otomasyona geç" akışındaki İLK elle test aracıdır — derin otomasyon (GRUP G-I) buradan SONRA gelir.
Formdan Gerçek Request'e
Swagger UI'da bir endpoint'e tıkladığında `Try it out` butonu belirir. Bu butona basınca alanlar DÜZENLENEBİLİR hale gelir, `Execute` butonu ise GERÇEK bir HTTP request'i gönderir — sonucu (status kodu, response gövdesi) tam olarak DevTools Network panelinde (GRUP E) göreceğinle aynı şekilde gösterir.
Spec → Swagger UI → Try it out → Gerçek Request
🎬 Kod Yazmadan İlk API Çağrısı
"Try it out" tıklanır
Gerçek status + gövde
Tester `/swagger-ui.html`'i açar — spec'teki tüm endpoint'ler görsel bir listede belirir.
`POST /api/v1/bugs` üzerinde `Try it out` butonuna basar — form artık DÜZENLENEBİLİR.
Spec'in zaten bildiği alanları (title, severity) doldurur — enum değerleri bile ÖNCEDEN listelenmiştir.
`Execute`'e basınca GERÇEK bir HTTP request'i sunucuya gider — bu bir simülasyon değildir.
Ders — Sonuç (status + gövde) DevTools'ta göreceğinle aynıdır; Swagger UI kod yazmadan yapılan bir "gerçek" ilk testtir, süs değildir.
Swagger UI'da İlk Elle Test Sırası
Genelde /swagger-ui.html veya /api-docs adresinde çalışır.