small medium large xlarge

Design and Build Great Web APIs: Robust, Reliable, and Resilient


Cover image for Design and Build Great Web APIs

Design and Build Great Web APIs

Robust, Reliable, and Resilient


APIs are transforming the business world at an increasing pace. Gain the essential skills needed to quickly design, build, and deploy quality web APIs that are robust, reliable, and resilient. Go from initial design through prototyping and implementation to deployment of mission-critical APIs for your organization. Test, secure, and deploy your API with confidence and avoid the “release into production” panic. Tackle just about any API challenge with more than a dozen open-source utilities and common programming patterns you can apply right away.

Choose Your Format(s)

  • $24.95 In Stock
    • Beta: What do I get?

  • Ebooks are DRM free.

  • Ebook delivery options.

About this Title

Pages: 250 (est)
Published: 2020-06-10
Release: B6.0 (2020-05-05)
ISBN: 978-1-68050-680-8

Good API design means starting with the API-first principle—understanding who is using the API and what they want to do with it—and applying basic design skills to match customers’ needs while solving business-critical problems. Use the Sketch-Design-Build method to create reliable and scalable web APIs quickly and easily without a lot of risk to the day-to-day business operations. Create clear sequence diagrams, accurate specifications, and machine-readable API descriptions, all reviewed, tested, and ready to turn into fully-functional NodeJS code.

Create reliable test collections with Postman and implement proper identity and access control security with AuthO—without added cost or risk to the company. Deploy all of this to Heroku using a continuous delivery approach that pushes secure, well-tested code to your public servers, ready for use by both internal and external developers.

From design to code to test to deployment, unlock hidden business value and release stable and scalable web APIs that meet customer needs and solve important business problems in a consistent and reliable manner.

What You Need

All the examples in this book are created using JavaScript and NodeJS installed on your own local laptop or workstation running Windows, MacOS, or Linux. You’ll need accounts on Github and Heroku in order to build, check in, and deploy your code to a live server. You’ll also be using Postman for testing, Auth0 to secure your APIs, and a handful of open-source command-line utilities and your favorite text editor to complete the exercises in the book.

Contents & Extracts

This book is currently in beta, so the contents and extracts will change as the book is developed.


  • Getting Started
    • Getting Started with API First excerpt
      • Adopting the API First Principle
      • Exploring APIs with curl
      • What’s Next?
      • Chapter Exercise
    • Understanding HTTP, REST, and APIs
      • Understanding Web API Protocols, Practices, and Styles
      • Managing Files with Git
      • What’s Next?
      • Chapter Exercise
  • The Design Phase
    • Modeling APIs
      • Understanding Norman’s Action Lifecycle
      • Modeling Our Onboarding API Lifecycle
      • Managing Your Project with npm
      • What’s Next?
      • Chapter Exercise
    • Designing APIs excerpt
      • The Power of Design
      • The API Design Method
      • Identifying Your API Descriptors
      • Creating Your Sequence Diagram
      • What’s Next?
      • Chapter Exercise
    • Describing APIs
      • Learning the Role of Description Formats
      • Describing Your API with ALPS
      • Generating API Docs with alps2doc
      • Updating Your API Project
      • What’s Next?
      • Chapter Exercise
  • The Build Phase
    • Sketching APIs excerpt
      • Learning from Frank Gehry’s Sketches
      • API Sketching Example
      • The Advantages of Sketching
      • Sketching APIs with Apiary Blueprint
      • API Sketching Tips and Tricks
      • What’s Next
      • Chapter Exercise
    • Prototyping APIs
      • Story Map
      • What is an API Prototype?
      • API Prototyping with Swagger
      • Chapter Summary
      • Chapter Exercise
    • Building APIs
      • Story Map
      • The Build Process
      • The D-O-R-R Method
      • Chapter Summary
      • Chapter Exercise
  • The Release Phase
    • Testing APIs
      • Story Map
      • The Goal of Testing
      • API Testing with Postman
      • Chapter Summary
      • Chapter Exercise
    • Securing APIs
      • Story Map
      • Understanding Security Basics
      • Implementing API Security with Auth0
      • Chapter Summary
      • Chapter Exercise
    • Deploying APIs
      • The Basics of Deployment Pipelines
      • The Role of DevOps
      • Deploying with Heroku
      • What’s Next?
      • Chapter Exercise
    • Modifying APIs
      • Story Map
      • Beyond Versioning
      • The Three Rules
      • Updating Your API
      • Chapter Summary
      • Chapter Exercise
  • Appendixes
    • Installation Hints
      • curl
      • git
      • GitHub and SSH
      • NodeJS and npm
      • Postman
      • Newman
      • Heroku Client
    • Exercise Solutions
      • Where’s the Code?
      • Getting Started with API-First
      • Understanding HTTP, REST, and APIs


An internationally known author and speaker, Mike Amundsen travels the world consulting and talking about network architecture, web development, and the intersection of technology and society. He works with companies large and small to help them capitalize on the opportunities APIs and microservices present for both consumers and the enterprise.