Chapter 11

Improving the Developer Experience

Every useful API that delivers value will typically have multiple consumers. This is a natural asymmetry, which will only increase over time.

— Mark O’Neill

When teams think about delivering an API, the primary focus is on the code that must be built. They focus on considerations such as the target programming language, frameworks that aid in building the API, continuous integration and delivery (CI/CD) pipelines, and other factors. While all of these decisions are important, they involve the API provider only. They do not directly empower the tens, hundreds, or thousands of future API consumers that will use the API.

As an API provider, it is important to keep the API consumers first in everything ...

Get Principles of Web API Design: Delivering Value with APIs and Microservices now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.