https://github.com/apisyouwonthate/book-build-apis-2

Learn how to build and leverage the latest technology in APIs, services, microservices, distributed systems, HATEOAS, query languages, circuit breakers, gateways, discombobulators, flux capacitors, spider monkeys...
https://github.com/apisyouwonthate/book-build-apis-2

Last synced: 3 months ago
JSON representation

Learn how to build and leverage the latest technology in APIs, services, microservices, distributed systems, HATEOAS, query languages, circuit breakers, gateways, discombobulators, flux capacitors, spider monkeys...

• Host: GitHub
• URL: https://github.com/apisyouwonthate/book-build-apis-2
• Owner: apisyouwonthate
• Created: 2019-02-01T08:43:17.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-04-11T23:46:20.000Z (over 1 year ago)
• Last Synced: 2024-05-21T07:27:11.421Z (6 months ago)
• Language: Ruby
• Homepage: https://apisyouwonthate.com
• Size: 19.2 MB
• Stars: 225
• Watchers: 46
• Forks: 24
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 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!**](https://leanpub.com/build-apis-you-wont-hate-2/)

## 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](https://github.com/apisyouwonthate/book-build-apis-2/raw/master/generated/book.pdf)