Chapter 3

API Decision Narratives

API endpoint, operation, and message design is multifaceted and therefore not easy. Requirements often conflict with each other, requiring balancing acts. Many architectural decisions and implementation choices have to be made, with numerous solution options available. The key to the success of an API is getting these decisions right. Sometimes the required choices are not known to developers, or developers know only a subset of the available options. Also, not all criteria may be obvious; for example, some quality attributes (such as performance and security) are more obvious than others (such as sustainability).

In this chapter, we identify pattern selection decisions by topical categories. The chapter walks ...

Get Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges 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.