Chapter 16
Continuing the API Design Journey
When done effectively, governance can provide clear direction, remove obstacles, and allow different parts of the organization to function independently.
— Matt McLarty
An organization that produces more than one API product must learn to scale its API design process. Otherwise, designs will lack consistency across the portfolio of APIs produced by the organization. Authentication and authorization will vary between APIs. Naming conventions and error responses will deviate. In short, the API program will become a mess.
This chapter explores the factors required to scale API design efforts within an organization. These factors include establishing a style guide for consistency, incorporating design ...
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.