Mike Amundsen - Design and Build Great Web APIs

Copyright 2020 The Pragmatic Programmers, LLC. This book is licensed to the individual who purchased it. We don't copy-protect it because that would limit your ability to use it for your own purposes. Please don't break this trustyou can use this across all of your devices but please do not share this copy with other members of your team, with friends, or via file sharing services. Thanks.

Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this book, and The Pragmatic Programmers, LLC was aware of a trademark claim, the designations have been printed in initial capital letters or in all capitals. The Pragmatic Starter Kit, The Pragmatic Programmer, Pragmatic Programming, Pragmatic Bookshelf and the linking g device are trademarks of The Pragmatic Programmers, LLC.

Every precaution was taken in the preparation of this book. However, the publisher assumes no responsibility for errors or omissions, or for damages that may result from the use of information (including program listings) contained herein.

The Pragmatic Bookshelf is an agile publishing company. Were here because we want to improve the lives of developers. We do this by creating timely, practical titles, written by programmers for programmers.

Our Pragmatic courses, workshops, and other products can help you and your team create better software and have more fun. For more information, as well as the latest Pragmatic titles, please visit us at http://pragprog.com.

Our ebooks do not contain any Digital Restrictions Management, and have always been DRM-free. We pioneered the beta book concept, where you can purchase and read a book while its still being written, and provide feedback to the author to help make a better book for everyone. Free resources for all purchasers include source code downloads (if applicable), errata and discussion forums, all available on the book's home page at pragprog.com. Were here to make your life easier.

Want to keep up on our latest titles and announcements, and occasional special offers? Just create an account on pragprog.com (an email address and a password is all it takes) and select the checkbox to receive newsletters. You can also follow us on twitter as @pragprog.

If you buy directly from pragprog.com, you get ebooks in all available formats for one price. You can synch your ebooks amongst all your devices (including iPhone/iPad, Android, laptops, etc.) via Dropbox. You get free updates for the life of the edition. And, of course, you can always come back and re-download your books when needed. Ebooks bought from the Amazon Kindle store are subject to Amazon's polices. Limitations in Amazon's file format may cause ebooks to display differently on different devices. For more information, please see our FAQ at pragprog.com/frequently-asked-questions/ebooks. To learn more about this book and access the free resources, go to https://pragprog.com/book/maapis, the book's homepage.

Thanks for your continued support,

Andy Hunt
The Pragmatic Programmers

The team that produced this book includes: Andy Hunt (Publisher) Janet Furlow (VP of Operations) Dave Rankin (Executive Editor) Molly McBeath (Copy Editor) Potomac Indexing, LLC (Indexing) Gilson Graphics (Layout)

For customer support, please contact .

For international rights, please contact .

First, I owe a debt of thanks to the many people who were involved in my API workshops and training sessions over the last several years. Many of the ideas and some of the tooling youll find in these pages is the direct result of the generous and valuable feedback provided by attendees from all walks of life.

I also want to thank all the conference organizers, reviewers, and event staff for the opportunity to share my thoughts and ideas with their skilled and discerning audiences. Every encounter has taught me important lessons and helped shape the content of this book.

And my gratitude extends to all the corporations and foundations that invited me into their organizations and allowed me to ask questions, probe into their API programs, and learn from their accumulated knowledge from teams around the world.

Of course, this book could not have come about without the help and support of the Pragmatic Bookshelf and its dedicated and professional staff. I thank Brian MacDonald, who helped me find a home for a book project Id been pitching for quite a while. And thanks to the whole team at the Bookshelf for their patience and assistance as I worked to bring together all Ive learned into a single place.