In Video Editions the narrator reads the book while the content, figures, code listings, diagrams, and text appear on the screen. Like an audiobook that you can also watch as a video.
Learn how to design web APIs that are a delight to use and maintain.
Thousands of developers have followed renowned API expert Arnaud Lauret’s guidance to create APIs that are flexible, secure, and easily integrated. This new edition of the bestselling The Design of Web APIs covers the latest updates to the OpenAPI standard, teaches you to streamline and standardize API design decisions with rationale and automation, and gives you insights you can apply to other API styles, such as gRPC. You’ll quickly see how a well-designed and properly-documented API gives your users autonomy—and saves you from constant explanations and hand-holding.
This fully revised second edition of The Design of Web APIs teaches you the principles and techniques you need to design easy-to-consume public and private web APIs. In it, you’ll learn how to:
Analyze requirements to identify API capabilities for versatile, reusable designs
Create HTTP-based REST APIs with CRUD, batch/bulk, or long operations
Design interoperable, user-friendly APIs with seamless operations and data flow
Ensure secure, efficient APIs while overcoming limitations and constraints
Modify APIs without breaking compatibility, evaluating consequences carefully
Future-proof your APIs and choose effective versioning strategies
Document REST APIs using OpenAPI and JSON Schema for seamless implementation
Streamline and standardize API design decisions with rationale and automation
The Design of Web APIs, Second Edition teaches vital skills for gathering requirements, balancing business and technical goals and constraints, and adopting a consumer-first mindset. Each chapter is packed full of hands-on examples, including designing an Online Shopping API and user-friendly banking operations, and over seventy exercises to help your new skills stick. Plus, you’ll explore paradigms applicable beyond REST APIs, and fully describe and document your APIs with OpenAPI and JSON Schema. Your web APIs will soon be easier to consume and your clients—internal and external—will be happier than ever!
About the Technology Web APIs open up your software to developers, exposing features, and capabilities to other programs. Well-designed web APIs are a joy. The bad ones are a nightmare, with endless impact on system performance, developer productivity, and end-user experience. This book shows you how to design APIs your fellow developers will love to use.
About the Book The Design of Web APIs, Second Edition teaches you to design efficient and adaptable REST APIs. This revised and rewritten second edition contains the latest updates to the OpenAPI standard, along with insights you can apply to other API styles such as GraphQL. Learn vital skills for gathering requirements, creating easy-to-consume public and private web APIs, and handling non-backward compatible modifications and versioning.
What's Inside
Design reusable, user-friendly and interoperable APIs
Document your APIs with OpenAPI and JSON Schema
Create secure and efficient APIs by design
Streamline and standardize API design decisions
About the Reader Written for developers with experience building and consuming APIs.
About the Author Arnaud Lauret runs the API Handyman blog and is a frequent speaker at API conferences. He currently works as an API Industry Researcher at Postman.
Quotes Brings together excellent knowledge, experience, and practices. Two thumbs up! - Mike Amundsen, Amundsen.com, Inc
Distills API design into a clear and understandable approach that will stand the test of time. - James Higginbotham, APICoach.io
You need this book on your bookshelf! Clear, informative, and practical. - Lorna Mitchell, OpenAPI Initiative
Design APIs with confidence! Arnaud’s approach is both easy to follow and instantly applicable. - Joyce Stack, Elsevier
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month, and much more.
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
Julian F.
Head of Cybersecurity
I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.
Addison B.
Field Engineer
I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.
Amir M.
Data Platform Tech Lead
I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.