# Developer Documentation

Welcome to the Bookhoard developer documentation. This section contains API references, protocol specifications, and technical documentation for integrating with Bookhoard.

## 📚 API Documentation

### Complete API Reference

- **[API Reference](api-reference.md)** - Complete REST API reference
  - Authentication
  - User management
  - Libraries
  - Media items
  - Reading progress
  - Notes & highlights
  - Analytics
  - Book matching
  - OPDS
  - Sync protocols (KOReader, Kobo)
  - WebSocket

### Split Endpoint Documentation

Browse individual endpoint documentation with interactive API Explorer:

- **[API Documentation](api/api-reference.md)** - Split endpoint docs
  - [Authentication](api/authentication/) - Register, login, tokens
  - [Users](api/users/) - Profile management
  - [Libraries](api/libraries/) - Library operations
  - [Media Items](api/media-items/) - Book/ebook management
  - [Progress](api/progress/) - Reading progress tracking
  - [Notes](api/notes/) - User notes
  - [Highlights](api/highlights/) - Book highlights
  - [Ratings](api/ratings/) - Book ratings
  - [Devices](api/devices/) - Device management
  - [Analytics](api/analytics/) - Usage statistics
  - [Book Matching](api/book-matching/) - Search and link books
  - [Collections](api/collections/) - Collection management
  - [OPDS](api/opds/) - Open Publication Distribution
  - [Sync Protocols](api/sync/) - KOReader and Kobo sync
  - [WebSocket](api/websocket/) - Real-time events

### Collections API

- **[Collections API](collections-api.md)** - Complete collections API reference
  - Create and manage collections
  - Auto-assign rules
  - Test rules
  - Bulk operations
  - Device shelf mappings

## 🔌 Protocol Specifications

### Sync Protocols

- **[Kobo Sync Protocol](api/sync/kobo-protocol.md)** - Kobo device sync protocol
  - Kobo markup sync
  - Library fetch
  - Authentication

- **[KOReader Sync Protocol](api/sync/koreader-protocol.md)** - KOReader sync protocol
  - Progress sync
  - Metadata fetch
  - Conflict handling

### WebSocket Protocol

- **[WebSocket API](websocket-api.md)** - Real-time sync and events
  - Connection flow
  - Message format
  - Event types
  - Authentication

## 🛠 Implementation Guides

### Calibre Integration

- **[Calibre OPF Implementation](../development/calibre-opf-implementation.md)** - Technical implementation details
  - Architecture and design
  - Data structures and functions
  - Database schema mapping
  - Testing strategy
  - Error handling
  - Performance considerations

---

**Looking for user documentation?** See the [User Portal](../user/user-guide.md)
**Need to deploy?** See the [Operations Portal](../operations/operations.md)
