.NET Core Web API: Swagger - OpenApi

Bu video, .NET Core Web API projelerinde Swagger ve OpenAPI yapılarının temelden ele alındığı teknik bir rehberdir. Videoda işlenen ana konular şunlardır:

• Swagger vs. OpenAPI: Standart olanın OpenAPI (dokümantasyon formatı), Swagger'ın ise bu dokümanı görselleştiren araç seti olduğu açıklanıyor (0:26-1:29).
• OpenAPI Yapılandırması: .NET 8 ve sonrasında gelen AddOpenApi() ve MapOpenApi() metotlarının teknik dokümantasyon (JSON) üretmek için nasıl kullanıldığı gösteriliyor (1:45-2:42).
• Swashbuckle Kurulumu: Görsel bir arayüz (Swagger UI) ve endpoint testi için Swashbuckle paketinin projeye dahil edilmesi ve Program.cs üzerinde yapılan servis/middleware ayarları anlatılıyor (5:46-6:18).
• Dokümantasyon Teknikleri:
  • XML Comments: XML dokümantasyon dosyasının oluşturulup Swagger'a tanıtılması (7:46-8:44).
  • Endpoint ve Parametre Tanımları: summary kullanımı, yanıt (response) tiplerinin (ProducesResponseType) belirlenmesi ve parametre açıklamalarının eklenmesi detaylandırılıyor (8:45-11:44).
• Güvenlik Yapılandırması: İleri düzey bir konu olarak, Swagger üzerinde JWT (Authorize) kilit simgesinin nasıl ekleneceğine dair teorik bilgiler paylaşılıyor (12:12-13:07).