Our task in this part of the book is to describe an API called FarmStall. FarmStall was designed specifically for this book, and it is intentionally as simple as possible. Before we can describe this API, we’ll need to understand how it works and be able to make HTTP requests and inspect the responses.
In this chapter we’ll use a tool called Postman to make HTTP requests against the FarmStall API (see figure 2.1). We’ll be verifying that we get decent-looking responses without concerning ourselves too much with the details of those responses. We’ll also take a basic look at the business domain of the API. We won’t go into great detail, but we’ll learn enough so that we have an understanding of what we’re doing. This will make it easier to describe later on.
- Postman—https://getpostman.com
- FarmStall API landing page—https://farmstall.designapis.com
- FarmStall API—https://farmstall.designapis.com/v1/reviews
- Source code (in Go)—https://github.com/designapis/farmstall