-
Book Overview & Buying
-
Table Of Contents
Building an API Product
By :
The API’s specification is directly related to the chosen architectural style. In other words, there’s at least one specification that’s compatible with each architectural style. Sometimes, the specification is even a part of the architectural style. For example, a REST API can be defined using the OpenAPI specification. However, OpenAPI can also define APIs that don’t follow the REST architectural style. As a different example, let’s say you define a GraphQL API using the architectural style documentation. There’s no need to use a separate specification. In either case, the outcome is that you will have a machine-readable API definition. This is important because API consumers communicate with APIs using tools that can read definitions. Without those machine-readable definitions, you would have to ask users to enter all the requested details by hand. Every time developers build an integration with an API, they can use a machine...