Designing APIs with Swagger and OpenAPI

9 Designing a web application

This chapter covers

• The goals, scenarios, and plan for the second part of this book
• Creating a domain model for the PetSitter application
• Adding functionality to the domain model with user stories

In the first part of this book, we went through the basics of APIs, how to use them, and how to formally describe them with OpenAPI. We also worked with Swagger Editor to document an existing API—the FarmStall API—using OpenAPI. Now, in the second part of this book, we’ll design a new API for a web application from scratch.

Going through the API design process and further through the API lifecycle is not just about using OpenAPI and various tools. It’s also about people and processes. There are always new requirements ...