The Design of Web APIs, Second Edition
eBook - ePub

The Design of Web APIs, Second Edition

  1. English
  2. ePUB (mobile friendly)
  3. Available on iOS & Android
eBook - ePub

The Design of Web APIs, Second Edition

About this book

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.

Frequently asked questions

Yes, you can cancel anytime from the Subscription tab in your account settings on the Perlego website. Your subscription will stay active until the end of your current billing period. Learn how to cancel your subscription.
At the moment all of our mobile-responsive ePub books are available to download via the app. Most of our PDFs are also available to download and we're working on making the final remaining ones downloadable now. Learn more here.
Perlego offers two plans: Essential and Complete
  • Essential is ideal for learners and professionals who enjoy exploring a wide range of subjects. Access the Essential Library with 800,000+ trusted titles and best-sellers across business, personal growth, and the humanities. Includes unlimited reading time and Standard Read Aloud voice.
  • Complete: Perfect for advanced learners and researchers needing full, unrestricted access. Unlock 1.4M+ books across hundreds of subjects, including academic and specialized titles. The Complete Plan also includes advanced features like Premium Read Aloud and Research Assistant.
Both plans are available with monthly, semester, or annual billing cycles.
We are an online textbook subscription service, where you can get access to an entire online library for less than the price of a single book per month. With over 1 million books across 1000+ topics, we’ve got you covered! Learn more here.
Look out for the read-aloud symbol on your next book to see if you can listen to it. The read-aloud tool reads text aloud for you, highlighting the text as it is being read. You can pause it, speed it up and slow it down. Learn more here.
Yes! You can use the Perlego app on both iOS or Android devices to read anytime, anywhere — even offline. Perfect for commutes or when you’re on the go.
Please note we cannot support devices running on iOS 13 and Android 7 or earlier. Learn more about using the app.
Yes, you can access The Design of Web APIs, Second Edition by Arnaud Lauret in PDF and/or ePUB format, as well as other popular books in Computer Science & Computer Science General. We have over one million books available in our catalogue for you to explore.

Information

Table of contents

  1. Praise for the first edition
  2. The Design of Web APIs, Second Edition
  3. copyright
  4. contents
  5. dedication
  6. foreword
  7. preface
  8. acknowledgments
  9. about this book
  10. about the author
  11. about the cover illustration
  12. 1 What is API design?
  13. Part 1 Fundamentals of API design
  14. 2 Identifying API capabilities
  15. 3 Observing operations from the REST angle
  16. 4 Representing operations with HTTP
  17. 5 Modeling data
  18. 6 Describing HTTP operations with OpenAPI
  19. 7 Describing data with JSON Schema in OpenAPI
  20. Part 2 User-friendly, interoperable API design
  21. 8 Designing user-friendly, interoperable data
  22. 9 Designing user-friendly, interoperable operations
  23. 10 Designing user-friendly, interoperable operation flows
  24. 11 Designing user-friendly, interoperable APIs
  25. Part 3 Constrained API design
  26. 12 Designing a secure API
  27. 13 Designing an efficient API
  28. 14 Adapting the API design to the context
  29. 15 Modifying an API
  30. Part 4 Scaled and simplified API design
  31. 16 Facilitating API design decision-making
  32. 17 Optimizing an OpenAPI document
  33. 18 Automating API design guidelines
  34. 19 Enriching API design artifacts
  35. appendix A. Solutions to the exercises