V: Refining the API Design

Following the ADDR Process so far, the outcomes have been identified and digital capabilities captured during the Align Phase. The Define Phase then elaborated on these details, forming API profiles with bounded scope and responsibilities. The Design Phase applies one or more API styles to the API profile, producing a high-level design of the APIs needed to deliver the desired outcomes.

The Refine Phase seeks to improve the developer experience and prepare for delivery of the API. Topics addressed in this section include decomposing an API into services to shift complexity, applying proper API testing strategies, and strategies for offering robust API documentation. Offering helper libraries and command-line interfaces is also explored. Finally, tips are provided for scaling the ADDR Process for larger organizations.