chapter two

2 A basic API implementation

 

This chapter covers

  • Reading and understanding the requirements of an API specification
  • Structuring our application into a data layer, an application layer, and an interface layer
  • Implementing API endpoints using FastAPI
  • Implementing data validation models (schemas) using Pydantic
  • Testing the API using a Swagger UI

In this chapter, we implement the API for the orders service, which is one of the microservices of the CoffeeMesh website, the project that we introduced in chapter 1. CoffeeMesh is an application that makes and delivers coffee on demand at any time, wherever you are. The orders service allows customers to place orders with CoffeeMesh. As we implement the orders API, you will get an early peek into the concepts and processes that we dissect in more detail throughout this book.

The code for this chapter is available under the folder ch02 of the GitHub repository provided with this book.

2.1 Introducing the orders API specification

2.2 High-level architecture of the orders application

2.3 Implementing the API endpoints

2.4 Implementing data validation models with Pydantic

2.5 Validating request payloads with Pydantic

2.6 Marshalling and validating response payloads with Pydantic

2.7 Adding an in-memory list of orders to the API

2.8 Summary