The microservice architecture relies heavily on API calls between gateway and services, services and registry, and gateway and registries. So it is essential for developers and users to get to know the API endpoints that they can access, as well as the information required to access those endpoints.
This can be a lot of work. Fortunately, libraries such as Swagger come to the rescue. We just have to add the standard comments to the methods, and then the Swagger API will do the necessary work to extract information from them and convert them into a beautiful user interface:
The preceding image shows the default generated ...
