When developing REST-driven applications, I find it really useful to use the facilities of Swagger (https://swagger.io). Swagger has many features that make it the go-to tool when we want to do things such as creating API documentation, creating code for APIs, and testing APIs.
We're going to use the Swagger UI to prototype the ability to retrieve a list of people. From this, we can generate documentation to go along with our API. While we could generate the code from this, we are going to use the tooling that's available to see what the shape of our final REST call will be, which we will use to roll our own implementation using the data model we created previously. The reason I like to do this is twofold. ...
