books/docs/architecture/external-apis.md
Greg fa8acef423 Epic 1, Story 1.1: Project Initialization & Repository Setup
- Initialize Git repository with main branch
- Create comprehensive .gitignore for Node.js, React, and environment files
- Set up directory structure (frontend/, backend/, docs/)
- Create detailed README.md with project overview and setup instructions
- Add .env.example with all required environment variables
- Configure Prettier for consistent code formatting

All acceptance criteria met:
 Git repository initialized with appropriate .gitignore
 Directory structure matches Technical Assumptions
 README.md created with project overview and setup docs
 .env.example file with all required environment variables
 Prettier config files added for code formatting consistency

🤖 Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 15:12:30 +01:00

1.1 KiB

External APIs

Open Library API

Key Endpoints Used:

  • GET /search.json?q={query} - Search for books by keyword, returns title, author, pages, cover IDs

Cover Images:

  • Base URL: https://covers.openlibrary.org/b/id/{cover_id}-{size}.jpg
  • Sizes: S (small), M (medium), L (large)
  • Example: https://covers.openlibrary.org/b/id/8233808-M.jpg

Integration Notes:

  • Cache search results for 1 hour to reduce API calls
  • Implement exponential backoff if rate limited (429 response)
  • Fallback to manual entry if API unavailable
  • Extract number_of_pages_median or first number_of_pages value for total pages
  • Some books may not have cover images (use placeholder)
  • Consider Google Books API as backup if Open Library quality is insufficient