Specifying the Order Management API
In this section, you will develop the specification of the operations and data structures of the Order Management API. The Order Management API, as part of the project we are building over the course of this book, will handle the orders of products managed by the Product API.
As explained in the previous chapter, specification-first means an abstract API specification is created before the actual implementation of the API. Instead of starting with executable code in a programming language, you begin by defining the structure, behavior, and functionality of the API. That is why this is also known as API-first development.
In Chapter 1, we visited many key principles that should be considered when designing RESTful APIs. Let us look at how to apply those principles with the API-first approach.
Implementing HTTP principles in API-first development
When adopting an API-first approach, it is crucial to think in HTTP terms right from the...