The API World has changed a lot since "Build APIs You Won't Hate" was published in 2014, and keeping the original book up-to-date with blog posts and bonus chapters in the ebook is only holding off the inevitable for so long.
Support the development of this book, and pre-order on LeanPub!, as we pick up rewriting in mid 2024. We're publishing new chapters as we go, but the price goes up. The earlier you buy the cheaper it will be, but you'll still get all the new chapters as they're released.
So far, this feels like how the book is gonna play out:
-
Part One: Theory
- APIs, Services, and Microservices
- Understanding Different Paradigms
- API Lifecycle
- API Descriptions
- Design Theory
- What is a URL
- Input and Output
- Success and Failure
- Resources & Collections (#38)
- Pagination (#32)
- Filtering
- Caching (#39)
- Validation
- Hypermedia Controls (HATEOAS)
- HTTP/1, HTTP/2 and HTTP/3
- HTTP/2 is a real world thing today use it
- Lets Stop Building Around a Network Hack
- Asynchronous Methodologies
- Authentication
- Security
- Horror Stories
- Third Parties Gone Wild (The Keycard Troubles of 2016)
- Stampeding Herds
- "Syncing" in Microservices
- Denial of Service Attacking Yourself
- Firing Data into Blackholes
-
Part Two: Planning & Design
- Editors
- Mocking
- Documentation
- Style Guides (#33)
-
Part Three: Building & Testing
- Building Blocks
- Serialization
- Deserialization
- Debugging
- Traffic Inspection
- Integration Testing
- Contract Testing
- End to End / Acceptance Testing
- Health Checks (#36)
- Load Testing
- Testing in Production
- Notes on Deployment
-
Part Four: Management & Experience
- Portals & Documentation
- API Gateways
- Gateway Validation
- Rate Limiting
- Analytics
- Governance
- Deprecation (#34)
- Versioning & Evolution (#35)
-
Part Five: Further Theory
- Picking Paradigms (#37)
- Common Architectures
- GraphQL as a Monolith
- REST wrapping Microservices
- Backend for Frontends (BFFs)