Build APIs You Won't Hate #2: This Time It's Serious!

The API World has changed a lot since 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.

Outline

So far, this feels like how the book is gonna play out:

Part One: Theory
- APIs, Services, and Microservices
- Understanding Different Paradigms
  - RPC
  - REST
  - Query Languages
- API Contracts
  - Service Model
  - Data Model
  - Design First vs Code First
- Design Theory
  - Resources
  - Collections
  - Pagination
  - Filtering
  - Caching
- Authentication
- Hypermedia Controls (HATEOAS)
  - Layers of abstraction on top of RPC
  - Next available actions
  - Standards (JSON:API, HAL, etc.)
- 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
  - Long Polling
  - Web Hooks (a.k.a Callbacks)
  - WebSockets
  - Message Brokers (AMQP, Kafka, etc.)
Part Two: Planning & Design
- API Specifications
  - Documentation
  - Mocking & Sandboxes
- Style Guides
- Error Formats
- Validation
Part Three: Testing & Monitoring
- 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
- API Gateways
- Gateway Validation
- Rate Limiting
- Analytics
- Governance (Speccy / Specteral / Stoplight)
- Deprecation
- Versioning & Evolution
Part Five: Further Theory
- Picking Paradigms
- Common Architectures
  - REST wrapping Microservices
  - Backend for Frontends (BFFs)

Preview

HTML5 Preview

marcusmoore/build-apis-2

Build APIs You Won't Hate #2: This Time It's Serious!

Outline

Preview