Our Patterns for API Design, also known as Microservice API Patterns (MAP), capture proven solutions to problems commonly encountered when specifying, implementing and maintaining message-based APIs.

MAP focusses on message representations – the payloads exchanged when APIs are called. These payloads vary in their structure as API endpoints and their operations have different architectural responsibilities. The chosen representation structures strongly influence the design time and runtime qualities of an API. The evolution of API specifications and their implementations has to be governed.

News Get Started

News (November 2022): Our patterns form the core of the book “Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges” in the Vaughn Vernon Signature series at Addison-Wesley Professional.

The MAP for Open API Design and Evolution

While much has been said about microservices in general and about supporting infrastructure architectures, the service API design has received less attention:

  • How many services should be exposed remotely? What is an adequate size for them?
  • How to ensure that the services provided by an API and their interactions with clients are loosely coupled? How much data should be exchanged in request and response messages? How often does this happen?
  • What are the most suitable message representations? How to agree on the meaning of each message?

Answering these questions is what this website is about. Our API design pattern language is organized into categories:

Foundation

Responsibility

Structure

Quality

Evolution

Eager to get going? Looking for more context and background information?

Guidance and Pointers

You can continue reading about MAP and related topics on any of these pages:

Feedback and input is appreciated! Contact us.

  1. DPR is a public repository of methods and practices that are applicable to service analysis and design, collected and curated by two of the MAP authors. DPR now comes as a Leanpub ebook too, also available in a bundle with the Software Architecture Lecture Notes by a third MAPer.