Service APIs Client-Service Interactions Request and Response Management Service Implementation Service Infrastructures Service Evolution API Patterns

API Patterns

It's been 7 years since "Service Design Patterns" (SDP) was published. I'm proud to say that the book has been printed in 4 languages, and continues to sell quite well. Thanks to everyone who bought a copy. I hope you got something out of it. And special thanks to Martin Fowler for allowing me to join your elite Signature Series.

I've seen a lot since then, and have catalogued many new patterns for web service and RESTful API design. I was incredibly fortunate to be the Chair of Akamai Technologies' API Working Group, from 2015-2017, and to have worked with some of the smartest engineers and architects on this planet, helping to make the Internet faster, more reliable, and more secure.

That's a long way of saying that I've learned a lot since the book was published, and have decided to publish a new set of API Patterns and Best Practices that will pick up from where SDP left off. This time, I'm not interested in writing a book. I'd prefer to be a bit more agile, but I may leverage "traditional publishing channels" on occasion for some content, tbd.

The content for this catalogue will appear gradually over time, through a sporadic and semi-frequent series of posts which will draw upon years of work with friends.

SPECIAL THANKS TO: Martin Meyer, Damien Coffey, Ben Cordes, Michael Sierra, David Whynacht, Manish Gupta, Jon Landis, Daniel Malcolm Abraham, Bartlomiej Szczepanik, Przemyslaw Pozniak, Yuruo Chen, Karl Redgate, Yana Kadiyska, Brian Buderman, Tadhg Pearson, Karol Romanowski, Eric Jerskey, Bradford Jones, Jason Tolwinski, and Sean McDermott

API Design Principles This document provides guidance on a number of principles and design heuristics that software developers and architects should consider when designing RESTful APIs. Recommendations have been grouped into to one of three "Maturity Levels" ... Basic, Intermediate, and Advanced.