The Architecture of your API Platform
Looking for the big picture of building APIs? This book is for you!
Building APIs that consumers love should certainly be the goal of any API initiative. However, it is easier said than done. It requires getting the architecture for your APIs right. This book equips you with both foundations and best practices for API architecture. This book presents best practices for putting an infrastructure in place that enables efficient development of APIs.
This book is for you if you want to understand the big picture of API design and development, you want to define an API architecture, establish a platform for APIs or simply want to build APIs your consumers love.
This book is NOT for you if you are looking for a step-by-step guide for building APIs, focusing on every detail of the correct application of REST principles. In this case I recommend the book API Design of the API-University Series.
What is API architecture? Architecture spans the bigger picture of APIs and can be seen from several perspectives:
API architecture may refer to the architecture of the complete solution consisting not only of the API itself but also of an API client such as a mobile app and several other components. API solution architecture explains the components and their relations to the software solution.
API architecture may refer to the technical architecture of the API platform. When building, running and exposing not only one, but several APIs, it becomes clear that certain building blocks of the API, runtime functionality, and management functionality for the API need to be used over and over again. An API platform provides an infrastructure for developing, running and managing APIs.
API architecture may refer to the architecture of the API portfolio. The API portfolio contains all APIs of the enterprise and needs to be managed like its product. API portfolio architecture analyzes the functionality of the API and organizes, manages and reuses the APIs.
API architecture may refer to the design decisions for a particular API proxy. To document the design decisions, API description languages are used. We explain the use of API description languages (RAML and Swagger) on many examples.
This book covers all of the above perspectives on API architecture. However, to become useful, the architecture needs to be put into practice. This is why this book covers an API methodology for design and development. An API methodology provides practical guidelines for putting API architecture into practice. It explains how to develop an API architecture into an API that consumers love.
A lot of the information on APIs is available on the web. Most of it is published by vendors of API products. I am always a bit suspicious of technical information pushed by product vendors. This book is different. In this book, a product-independent view on API architecture is presented.
The API-University Series is a modular series of books on API-related topics. Each book focuses on a particular API topic, so you can select the topics within APIs, which are relevant to you.
Keywords: API Management, API Architecture, Integration, API Description Languages, RAML, Swagger, API
“After having read the first few chapters and learning more about various API stakeholders (providers, consumers, end users) I started to understand conversations going on at the workplace, which I was unable to grasp before. Digging further into the API Architecture I learned about key qualities of APIs (consistency, reusability, customization, discoverability, longevity and also about other architectural styles besides REST, such as HATEOAS, RPC, and SOAP.” More…
— Ivan Burda on June 13th, 2018
“I really appreciate your books on APIs. I also frequent your blog on api-university.com, it’s almost entertainment. Please keep doing what you do.”
“Great book. As a 25 year techie, I enjoy concise and practical technical docs, this is one!”
“I just wanted to tell you how much I am enjoying your first book !! Design is my thing – but I’ve never had a need to design an API but I know your books are going to make sure I get it right the first time !”
Get a Better API Job
Profit from what you have learned and find a better job in the API space.
Title: API Architecture