Principles of Web API Design • James Higginbotham & Mike Amundsen

Learn the principles of web API design from James Higginbotham and Mike Amundsen, covering topics like job stories, domain modeling, business-technical alignment, and more.

Key takeaways
  • The importance of understanding the job to be done, and how to use tools like job stories and activity steps to identify the scope of an API
  • The need for a North Star to guide API design, such as the modeling of the domain
  • The importance of alignment between business and technical teams, and how to use techniques like semantic versioning to manage changes
  • The need for a portal or API gateway to manage access to APIs, and how to use techniques like API composition to reduce complexity
  • The importance of understanding the scope and responsibilities of an API, and how to use techniques like event storming to identify boundaries
  • The need for a lean and agile approach to API development, including the use of iterative design and continuous improvement
  • The importance of understanding the customer’s needs and using empathy to design APIs that meet those needs
  • The need for a cohesive and aligned approach to API design, including the use of APIs as products that need to be nurtured and developed
  • The importance of understanding the distinction between modeling and design, and how to use techniques like Lambda and serverless functions to improve API development
  • The need for a framework or methodology to guide API design, such as Vlingo
  • The importance of understanding the ecosystem and the relationships between different APIs, and how to use techniques like semantic versioning to manage changes