The API-first development is one of the hottest technical topics in 2020, since many companies started to realize that API serves as a multiplicator to their opportunities—but it also amplifies the design mistakes as well.
The book is dedicated to designing APIs, how to build the architecture properly, from a high-level planning down to final interfaces.
Before we start talking about the API design, we need to explicitly define what the API is. Encyclopedia tells us that ‘API’ is an acronym for ‘Application Program Interface’.This definition is fi ne, but useless. Much like ‘Man’ definition by Plato: Man stood upright on two legs without feathers. This definition is fi ne again, but it gives us no understanding of what's so important about a Man. (Actually, not ‘fine’ either. Diogenes of Sinope once brought a plucked chicken, saying ‘That's Plato's Man’. And Plato had to add ‘with broad nails’ to his definition.)