Rest API uygulamaları yazarken kaç tane endpointin olduğu, hangi endpointin ne işe yaradığı, hangi endpointe nasıl istek atacağını belirlemek için ya geleneksel yöntem olarak herşeyi elle yazarak bir dökümantasyon sağlanmalı. Bu şekilde API'yi kullanan kişi ne iş için neyi kullandığını/kullanacağını anlasın. Eğer geleneksel yöntemi takip etmek istemiyorsanız, biraz daha otomatik, biraz daha kolay ve kullanışlı bir dökümantasyon yapmak isterseniz, önünüze ilk seçenek olarak swagger çıkıyor. Sadece dökümantasyon için kullanılmıyor. Rest API client kodu da üretiyor. Oradan direk istek gönderip sonuçları alabiliyorsunuz. Postman tarzı bir uygulama kullanmadan da işinizi yapabiliyorsunuz.
Kendi internet sitesi
https://swagger.io/tools/swagger-ui/