Designing APIs with Swagger and OpenAPI

2 Getting set up to make API requests

This chapter covers

• Introducing the FarmStall API and some of its business logic
• Introducing a tool to make HTTP requests: Postman
• Executing API requests and inspecting the responses

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 ...