Swagger Nedir?
Web Uygulama yazdığımız zaman bu uygulamaya erişim için bazı uçlar bırakıyoruz. Bu uçlara uygulama arayüzü ya da kısaca API diyoruz. Uygulamalar, takımlar arası çalışma bu arabirim üzerinden, arabirimin belirttiği standartlarda yapılır.
API’lerin kullandığı diller “standartlar” dan en bilinenleri SOAP ve REST’ dir. SOAP’ da XML bir veri yapısı , REST’ de ise JSON veri yapısı kullanılır.
İşin büyüklüğü ne olursa olsun API’lerin dokümtasyonu çok çok önemlidir. Dokümantasonu elle yapmaya çalışmanızı önermiyorum. Küçük uygulamalardan itibaren araçlar kullanmanız, iş hayatınızda konfor sağlayacaktır.
Bu amaçla kullanılan bir yazılımda Swagger’ dır. Swagger uygulaması REST API’ ler için dokümantasyonu sağlar, kaynak kodlarınızı paylaşmadan modüller arası iletişimi sağlarsınız.
Ben Swagger’ ı Java Maven ortamında kullandım. Öncelikle Maven’ e Swagger’ ı ekliyorsunuz. Ardından Swagger’ ı konfigüre ederek işiniz bitiyor.
Swagger size adres-url/swagger-ui-html gibi bir adresten tüm bilgiyi verecektir.
Swagger adresi swagger.io, bu adresten kayıt olabilirsiniz.