Build a real API with FastAPI.

Meet Shelf.

Want to read it, reading it, done. Shelf keeps the list. Reads are open; writes need a key. Small enough for one afternoon, real enough to deploy.

• GET/booksList books, with filters and pages
• GET/books/{book_id}One book
• POST/booksAdd a bookkey
• PATCH/books/{book_id}Change only what you sendkey
• DELETE/books/{book_id}Remove a bookkey
• POST/books/{book_id}/finishMark done, rate, log itkey
• GET/statsCounts and average rating
• GET/activityWhat happened recently
• GET/readyCan it serve traffic?

POST /books
X-API-Key: dev-key-change-me

{ "title": "Piranesi", "author": "Susanna Clarke", "tags": ["Fantasy"] }

{
  "id": 1,
  "title": "Piranesi",
  "author": "Susanna Clarke",
  "status": "want",
  "rating": null,
  "tags": ["fantasy"]
}

Real requests and responses from the API you will build, trimmed for space.