Swagger dokümantasyonunu manuel JSON yazarak oluşturmak zorunda değilsiniz.
En pratik yöntem, proje içinde otomatik dokümantasyon üreten bir yapı kullanmak.
İzlemeniz gereken yol şu şekilde:

1. Swagger için otomatik tarama yapan bir paket kuruyorsunuz.
2. API dosyalarını bu araca gösteriyorsunuz.
3. Araç tüm endpoint’leri kendi tarayıp Swagger formatına dönüştürüyor.
4. Sonuçta manuel olarak binlerce satır JSON yazmanıza gerek kalmıyor.

Bu yöntemle 80+ endpoint bile olsa dakikalar içinde Swagger dokümanı çıkartabilirsiniz.

iyi çalışmalar...