book-build-apis-2

by apisyouwonthate

apisyouwonthate / book-build-apis-2

Learn how to build and leverage the latest technology in APIs, services, microservices, distributed ...

217 Stars 14 Forks Last release: Not found 147 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Design APIs You Won't Hate

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.

Support the development of this book, and pre-order on LeanPub!

Outline

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

  • [ ] Part One: Theory

    • [x] APIs, Services, and Microservices
    • [x] Understanding Different Paradigms
    • [x] Input and Output
    • [x] Success and Failure
    • [x] API Contracts
    • [ ] Design Theory
    • [ ] Resources
    • [ ] Collections
    • [ ] Serialization
    • [ ] Deserialization
    • [ ] Pagination
    • [ ] Filtering
    • [ ] Caching
    • [ ] Validation
    • [ ] 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
    • [x] 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

    • [x] Editors
    • [x] Mocking
    • [x] Documentation
    • [ ] Style Guides
  • [ ] Part Three: Building & 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 (Speccy / Specteral / Stoplight)
    • [ ] Deprecation
    • [ ] Versioning & Evolution
  • [ ] Part Five: Further Theory

    • [ ] Picking Paradigms
    • [ ] Common Architectures
    • [ ] GraphQL as a Monolith
    • [ ] REST wrapping Microservices
    • [ ] Backend for Frontends (BFFs)

Preview

PDF Preview

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.