Book Image

Building an API Product

By : Bruno Pedro
Book Image

Building an API Product

By: Bruno Pedro

Overview of this book

The exponential increase in the number of APIs is evidence of their widespread adoption by companies seeking to deliver value to users across diverse industries, making the art of building successful APIs an invaluable skill for anyone involved in product development. With this comprehensive guide, you’ll walk through the entire process of planning, designing, implementing, releasing, and maintaining successful API products. You’ll start by exploring all aspects of APIs, including their types, technologies, protocols, and lifecycle stages. Next, you’ll learn how to define an API strategy and identify business objectives, user personas, and jobs-to-be-done (JTBD). With these skills, you’ll delve into designing and validating API capabilities to create a machine-readable API definition. As you advance, the book helps you understand how to choose the right language and framework for securely releasing an API server and offers insights into analyzing API usage metrics, improving performance, and creating compelling documentation that users love. Finally, you’ll discover ways to support users, manage versions, and communicate changes or the retirement of an API. By the end of this API development book, you’ll have the confidence and skills to create API products that truly stand out in the market.
Table of Contents (26 chapters)
1
Part 1:The API Product
6
Part 2:Designing an API Product
11
Part 3:Implementing an API Product
16
Part 4:Releasing an API Product
20
Part 5:Maintaining an API Product

Stakeholders

By definition, stakeholders are anyone that has an interest or concern in the development and management of your API product. These can range from existing customers who have direct involvement in the API product to potential competitors who are observing your strategy and seeing how it can influence theirs. Your job is to identify, categorize, and understand each and every stakeholder.

Let’s start by understanding how existing customers can influence the success of your API product. Customers are the primary users and source of revenue for your API product. The more customers you have, the more revenue you can potentially generate and the more you can learn to improve your API. Customers give you direct feedback about the quality of your API that you can use to adapt your strategy to reach your goals. If customers are on the user side of your API product, company shareholders or partners are on the investor side. Their needs relate to business factors and how...