Irresistible APIs

A Web API is a platform with a web-style interface developers can use to implement functionality. Well-designed APIs feel like a natural extension of the application, rather than just a new interface into the backend database. Designing Web APIs based on use cases allows an organization to develop irresistible APIs, which developers can consume easily and which support the business values of that organization.

About the Technology
It takes a village to deliver an irresistible web API. Business stakeholders look for an API that works side-by-side with the main product to enhance the experience for customers. Project managers require easy integration with other products or ways for customers to interact with your system. And, developers need APIs to consistently interoperate with external systems. The trick is getting the whole village together. This book shows you how.

About the Book
Irresistible APIs presents a process to create APIs that succeed for all members of the team. In it, you’ll learn how to capture an application’s core business value and extend it with an API that will delight the developers who use it. Thinking about APIs from the business point of view, while also considering the end-user experience, encourages you to explore both sides of the design process and learn some successful biz-to-dev communication patterns. Along the way, you’ll start to view your APIs as part of your product’s core value instead of just an add-on.

What’s Inside

• Design-driven development
• Developing meaningful use cases
• API guiding principles
• How to recognize successful APIs

About the Reader
Written for all members of an API design team, regardless of technical level.

About the Author
Kirsten Hunter is an API evangelist who helps developers and business stakeholders understand, design, and deliver amazing APIs.

Table of Contents

1. 1. What makes an API irresistible?
2. 2. Working with web APIs
3. 3. API First
4. 4. Web services explained
5. 5. Guiding principles for API design
6. 6. Defining the value for your API
7. 7. Creating your schema model
8. 8. Design-driven development
9. 9. Empowering your developers

10. DESIGNING WEB APIs

11. UNDERSTANDING WEB APIs