Build APIs You Won't Hate: Second Edition
Build APIs You Won't Hate: Second Edition
Minimum price
Suggested price
Build APIs You Won't Hate: Second Edition

This book is 10% complete

Last updated on 2019-04-27

About the Book

APIs have increased in popularity substantially over the last decade, from people just starting to build "the API" for their company,all the way to now where even small teams are building out multiple APIs and getting into distributed architectures with microservices. Many folks start building and building and after they have a few services in place they realize that everything is a mess and nobody knows what they are dong. We've all been there; somebody you didn't know changed a field you didn't know existed in an API you have never heard of, and now the men in suits have come downstairs to see why their company is on the news because of downtime issues in Australia mean nobody's keycard is working so nobody can use the bathroom.

Eventually a new tool pops up which promises to help with all those problems and people rush to rewrite everything in that tool, creating brand new terrible design decisions and losing all the valuable learning's from the last previous mistakes.

Let's fix this cycle, by focusing on API theory in general, and then zoom in on how these things are done in HTTP in general, REST, GraphQL and gRPC - three popular approaches to building APIs right now.

The book is broken into five parts:

  1. Theory
  2. Planning & Design
  3. Building & Testing
  4. Management & Experience
  5. Further Theory

The theory section will teach you a lot about API development in general, without tying your knowledge to a specific tool (tools change!) Learn about how HTTP/2 and HTTP/3 change API development entirely. Never heard of HTTP/3? Yeah! Many developers have only heard of HTTP/2 in passing, but it changes everything about API development.

Then we get into designing APIs using description formats like OpenAPI and AsyncAPI, using GUI editors to easily create description documents. These description documents can be used to create realistic mock APIs for folks to play with and confirm things work right before you start wasting your time writing code incorrectly. Design first is a beautiful thing.

Building and testing will very briefly help you pick the right collection of tools to put together to achieve the functionality you need, with examples in a bunch of different languages, before very quickly moving onto testing. The concepts of testing will last forever even though the tools change, so spending more time there will allow you to swap out the building blocks and keep on developing for a long time.

Management and developer experience could almost be its own book, the world of API Gateways are crucial these days, to avoid you repeating a bunch of cruft between all your APIs, leading to pointlessly inconsistent authentication experiences, different rate limiting policies, etc. The practices needed to make a good Developer Portal are haaaaaaaaard, but very important if you plan on opening your API to the public. Learn how these things can all fit togehter, with Governance coming into play to help ensure quality.

There's gonna be a lot of stuff in this book folks. My fingers may never be the same again.

About the Author

Phil Sturgeon
Phil Sturgeon

Since 2010 I've worked as a freelancer, consultant, Head of API, and CTO, for several API-centric technology startups. Most recently I have been working as an internal API consultant for WeWork, where I used my experience to help educate developers, define standards for API design and architecture, and work on open-source tooling like OpenAPI, JSON Schema, and HTTP. WeWork has 50+ APIs, and trying to get them all playing nicely together was a constant source of learning for me and those involved. Timeouts, circuit breakers, using service mesh instead of just hoping for the best, nd generally focusing on better design, leveraging async whenever possible, and all sorts of other interesting issues.

When I'm not fighting APIs I'm riding bikes. Racing them, crashing them, or rolling around with my mates, I'm either on two wheels, writing about tech, having a cider, or D) all of the above.

Table of Contents

Part One: Theory

 - APIs, Services, and Microservices

 - Understanding Different Paradigms

 - API Contracts

 - Design Theory

   - Resources

   - Collections

   - Serialization

   - Deserialization

   - Pagination

   - Filtering

   - Caching

 - Hypermedia Controls (HATEOAS)

 - Errors and Validation

 - HTTP/1, HTTP/2 and HTTP/3

 - Asynchronous Methodologies

 - Authentication

 - Security

Part Two: Planning & Design

 - Editors

 - Mocking

 - Documentation

 - Style Guides

Part Three: Development & Testing

 - Building Blocks

 - Debugging

 - Traffic Inspection

 - Integration Testing

 - Contract Testing

 - End to End / Acceptance Testing

 - Health Checks

 - Load Testing

 - Testing in Production

 - Notes on Deployment

Part Four: Management & Experience

 - Portals & Documentation

 - API Gateways

 - Gateway Validation

 - Rate Limiting

 - Analytics

 - Governance

 - Deprecation

 - Versioning & Evolution

Part Five: Further Theory

 - Picking Paradigms

 - Common Architectures

   - REST wrapping Microservices

   - Backend for Frontends (BFFs)

Authors have earned$9,202,676writing, publishing and selling on Leanpub,
earning 80% royalties while saving up to 25 million pounds of CO2 and up to 46,000 trees.

Learn more about writing on Leanpub

The Leanpub 45-day 100% Happiness Guarantee

Within 45 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

See full terms

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers), EPUB (for phones and tablets) and MOBI (for Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses! Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks. Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. It really is that easy.

Learn more about writing on Leanpub