The microservice architecture relies heavily on API calls between the gateway and services, services and the registry, and the gateway and registries. Therefore, it is essential for developers and users to get to know the API endpoints that they can access, as well as the information that's 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; then, the Swagger API will do the necessary work to extract information from them and convert them into a beautiful user interface:
The preceding screenshot ...
