Learn how to build robust, future-proof APIs by applying the latest industry best practices, avoiding common pitfalls, and understanding anti-patterns

Free with your book: DRM-free PDF version + access to Packt's next-gen Reader*

Key Features

Design APIs with your audience in mind to improve usability, lifecycle management, and communication
Learn how to create a client-centric REST API design leveraging OpenAPI and JSON Schema
Explore API versioning strategies, and gain hands-on experience with API testing and implementation
Purchase of the print or Kindle book includes a free PDF eBook

Book Description

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

What you will learn

Assess your client's needs to design APIs that communicate the value of your product
Understand the role of API lifecycle and the importance of contracts
Apply domain-driven design principles in API architecture
Embrace a modern approach to REST API design
Use the OpenAPI Specification and JSON Schema for standardized APIs
Evolve, maintain, and deprecate your APIs without disrupting your users

Who this book is for

This book is for professionals involved in the digital product lifecycle who want to deepen their understanding of API design and build future-proof APIs with a product-centric approach. API developers, solution architects and engineers, technical product owners, and software architects looking to extend their skills in creating efficient, scalable, and maintainable APIs will find this book particularly useful. Basic knowledge of APIs and the HTTP protocol is recommended to fully benefit from the design principles and practices covered.

The “Why” of API Development
API as a Product: Designing APIs with a Product Mindset
Understanding Application and API Lifecycles
Applying Domain-Driven Design to APIs
Comparing and Choosing the Right API Style
REST Design Constraints and Maturity Models
Constructing an API Design Domain Model
Designing and Managing Effective API Contracts
Understanding the OpenAPI Specification
OpenAPI as a Contract: Best Practices and Implementation
Using JSON Schema to Define Your Object Models
Don't Hate Your Hypermedia: Creating APIs For Humans and AIs
API Change Management: Strategies for Versioning and Evolution

About the Authors

Andrzej Jarzyna has 14+ years of API expertise, starting at 3scale where he helped clients build their API programs. He honed his architectural skills developing a health research API platform in Mozambique. As adidas' API Evangelist, he led API initiatives and established an API excellence center. At ING bank, he led their policy as code for APIs initiative while at PZU S.A. he led the API Governance program. Andrzej is active in the community, organizing API Days Barcelona, co-organizing API Strategy conferences, and running the API Meetup Barcelona. He shares insights at industry conferences and co-founded gaming startup Timewarp Inc. Andrzej enjoys balancing tech innovation with climbing and mountaineering.

Samir Amzani is an independent API consultant specializing in API-first transformations for leading organizations. With over 18 years of experience, he has guided companies like Goodbarber, Dailymotion, Adidas, BackMarket, AsyncAPI, and Postman in building scalable and efficient API ecosystems. As a Technical Steering Committee (TSC) member at AsyncAPI and an active contributor and maintainer of various open-source projects, Samir leverages his deep expertise to connect people, technology, and governance, driving impactful API strategies. Outside work, he finds inspiration in travel and music, continually supporting engineers and organizations to reach their full potential.

"About this title" may belong to another edition of this title.

Store Description

We first started out as ?The Paperback Exchange,? a chain of physical bookstores where we would part exchange your beloved books for new stories to transport you to faraway places. However, as shopping started to evolve to online shops and marketplaces, we bid our stores goodbye to become ?PBShop.? This transition has only allowed us to blossom as we now ship thousands of titles to book lovers across the globe. We pride ourselves in being a community of local book lovers which allows our passion and devotion to shine in everything we do. In 2020 we not only celebrated our 20th birthday but our 1st birthday as being completely employee owned after becoming an E.O.T in September 2019. We are proud to be different and embrace standing apart on a book mountain by working from a virtual inventory which allows us to provide thousands of books that may be difficult to get for your bookshelf or your studies. Working with a number of different suppliers allows us to explore other avenues such as puzzles, sheet music and even stationery so we really do have something for everyone. Life is about being versatile in all realms of existence. If this is your first visit or you are a returning customer, we would like to welcome you to the PBShop family, for there is no friend as loyal as a book. We are a company who put our customers at the centre of everything we do as we understand the importance of reading because once you learn to read, you will forever be free. There are a whole lot of things in this world of ours that we are yet to explore, which is why we will forever inspire curious minds.

Visit Seller's Storefront

Seller's business information

Pbshop.co.uk Ltd
Unit 22 Horcott Industrial Estate, Horcott Road, Fairford, GL7 4BX, United Kingdom

Sale & Shipping Terms

Terms of Sale

Returns Policy
We ask all customers to contact us for authorisation should they wish to return their order. Orders returned without authorisation may not be credited.
If you wish to return, please contact us within 14 days of receiving your order to obtain authorisation.

Returns requested beyond this time will not be authorised.

Our team will provide full instructions on how to return your order and once received our returns department will process your refund.
Please note the cost to return any...

More Information

Right of withdrawal

If you are a consumer you can withdraw from the contract in accordance with the following. Consumer means any natural person who is acting for purposes which are outside his trade, business, craft or profession.

Information regarding the right of withdrawal

Statutory right to withdraw

You have the right to withdraw from this contract within 14 days without giving any reason.

The withdrawal period will expire after 14 days from the day on which you acquire, or a third party other than the carrier and indicated by you acquires, physical possession of the last good or the last lot or piece.

To exercise the right of withdrawal, electronically fill in and submit a clear statement on our website, under "My Purchases" in "My Account". We will communicate to you an acknowledgement of receipt of such a withdrawal on a durable medium (e.g. by e-mail) without delay.

To meet the withdrawal deadline, it is sufficient for you to send your communication concerning your exercise of the right of withdrawal before the withdrawal period has expired.

Effects of withdrawal

If you withdraw from this contract, we will reimburse to you all payments received from you, including the costs of delivery (except for the supplementary costs arising if you chose a type of delivery other than the least expensive type of standard delivery offered by us).

We may make a deduction from the reimbursement for loss in value of any goods supplied, if the loss is the result of unnecessary handling by you.

We will make the reimbursement without undue delay, and not later than 14 days after the day on which we are informed about your decision to withdraw from this contract.

We will make the reimbursement using the same means of payment as you used for the initial transaction, unless you have expressly agreed otherwise; in any event, you will not incur any fees as a result of such reimbursement.

We may withhold reimbursement until we have received the goods back, or you have supplied evidence of having sent back the goods, whichever is the earliest.

You shall send back the goods or hand them over to PBShop.store US, Springfield Gardens, New York, U.S.A., +44 1285 712917, without undue delay and in any event not later than 14 days from the day on which you communicate your withdrawal from this contract to us. The deadline is met if you send back the goods before the period of 14 days has expired. You will have to bear the direct cost of returning the goods. You are only liable for any diminished value of the goods resulting from the handling other than what is necessary to establish the nature, characteristics and functioning of the goods.

Exceptions to the right of withdrawal

The right of withdrawal does not apply to:

The delivery of newspapers, journals or magazines with the exception of subscription contracts; and
The supply of digital content which is not supplied on a tangible medium (e.g. on a CD or DVD) if you accepted when you placed your order that we could start to deliver it, and that you could not withdraw once delivery had started.

Shipping Terms

Books are shipped from our US or UK warehouses. Delivery estimates allow for delivery from either location.

Shipping rates within U.S.A.

Shipping rates within U.S.A.
Order quantity	7 to 14 business days	7 to 14 business days
First item	� 0.00	� 0.00

Delivery times are set by sellers and vary by carrier and location. Orders passing through Customs may face delays and buyers are responsible for any associated duties or fees. Sellers may contact you regarding additional charges to cover any increased costs to ship your items.