Sign In Start Free Trial
Account

Add to playlist

Create a Playlist

Modal Close icon
You need to login to use this feature.
  • Book Overview & Buying RESTful API Design Patterns and Best Practices
  • Table Of Contents Toc
RESTful API Design Patterns and Best Practices

RESTful API Design Patterns and Best Practices

By : Andrzej Jarzyna, Samir Amzani
close
close
RESTful API Design Patterns and Best Practices

RESTful API Design Patterns and Best Practices

By: Andrzej Jarzyna, Samir Amzani

Overview of this book

Designing scalable, user-focused, and robust APIs that last isn’t just a technical challenge but a design imperative. Written by API leaders with over 30 years of combined experience in API strategy, governance, and community, this book is your comprehensive guide to API design, focusing on domain-driven, consumer-centric APIs that meet real user needs while remaining flexible and maintainable over time. It covers modern REST API design, tools like OpenAPI and JSON Schema, and the importance of a product-based approach. The chapters help you explore best practices, potential pitfalls, and anti-patterns, extending beyond the design phase. Starting with the “why” behind building an API, its intended users, and value, this book walks you through the API lifecycle, the role of contracts, and applying domain-driven design. You’ll develop a solid foundation in REST API design as you discover different styles, constraints, and more. Beyond design, the book covers testing techniques, API evolution, maintenance, and deprecation. By the end, you’ll not only know how to design great APIs but understand how to treat them as products, manage their lifecycle, and deliver real value by keeping your APIs relevant and reliable long after release. *Email sign-up and proof of purchase required
Table of Contents (20 chapters)
close
close
Lock Free Chapter
1
The Apprentice’s Study – Preparing for the Craft
6
The Wizard’s Grimoire – Mastering the Fundamentals of REST
11
The Archmage’s Circle – Forging and Evolving API Contracts
18
Other Books You May Enjoy
19
Index

API maturity

When designing APIs, we adhere to a certain set of rules. Usually, these rules would be the design constraints specific to the architectural style we have chosen. In our case, that would be REST. Additionally, we aim to follow a set of guidelines, such as industry best practices or internal organization rules. This is a crucial step to ensure our API’s quality as early as possible in the design stage of its life cycle.

In this section, we examine two models for assessing API design maturity. Maturity models provide a structured way to validate and score the quality of an API design. We begin with the Richardson Maturity Model (RMM), which evaluates how closely an API aligns with the constraints of the REST architectural style. Next, we turn to the Web API Design Maturity Model (WADMM), which focuses on assessing how client-centric an API is through the design of its document model. Let’s explore each of these maturity models in more detail.

...
Visually different images
CONTINUE READING
83
Tech Concepts
36
Programming languages
73
Tech Tools
Icon Unlimited access to the largest independent learning library in tech of over 8,000 expert-authored tech books and videos.
Icon Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.
Icon 50+ new titles added per month and exclusive early access to books as they are being written.
RESTful API Design Patterns and Best Practices
notes
bookmark Notes and Bookmarks search Search in title playlist Add to playlist download Download options font-size Font size

Change the font size

margin-width Margin width

Change margin width

day-mode Day/Sepia/Night Modes

Change background colour

Close icon Search
Country selected

Close icon Your notes and bookmarks

Confirmation

Modal Close icon
claim successful

Buy this book with your credits?

Modal Close icon
Are you sure you want to buy this book with one of your credits?
Close
YES, BUY

Submit Your Feedback

Modal Close icon
Modal Close icon
Modal Close icon