john-okeefe
de4f2ba7d8
- get_universal_progress.md - GET /api/progress/:id - update_universal_progress.md - POST /api/progress/:id - get_progress_history.md - GET /api/progress/:id/history Documents device-agnostic (universal) reading progress tracking that works across all devices (Kobo, KOReader, etc.)
55 lines
1.1 KiB
Markdown
55 lines
1.1 KiB
Markdown
# Get Library Statistics
|
|
|
|
Get statistics for a specific library.
|
|
|
|
**Endpoint**: `GET /api/libraries/:id/stats`
|
|
**Auth**: Required (Admin only)
|
|
|
|
## Path Parameters
|
|
|
|
| Parameter | Type | Required | Description |
|
|
|-----------|------|-----------|-------------|
|
|
| id | string (UUID) | Yes | Library UUID |
|
|
|
|
## Request Headers
|
|
|
|
| Header | Type | Required | Description |
|
|
|--------|------|-----------|-------------|
|
|
| Authorization | string | Yes | Bearer token (must have admin role) |
|
|
|
|
### Example Request
|
|
|
|
```http
|
|
GET /api/libraries/550e8400-e29b-41d4-a716-446655440000/stats
|
|
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
|
|
```
|
|
|
|
## Response (200 OK)
|
|
|
|
```json
|
|
{
|
|
"library_id": "uuid",
|
|
"total_media_items": 1523,
|
|
"total_size_bytes": 5368709120,
|
|
"last_scan": "2026-02-08T10:00:00Z",
|
|
"formats": {
|
|
"epub": 1234,
|
|
"kepub": 189,
|
|
"mobi": 50,
|
|
"pdf": 50
|
|
}
|
|
}
|
|
```
|
|
|
|
## Error Responses
|
|
|
|
| Code | Description |
|
|
|------|-------------|
|
|
| 401 | Invalid or expired token |
|
|
| 403 | User does not have admin privileges |
|
|
| 404 | Library not found |
|
|
|
|
## Try It Out
|
|
|
|
<!-- API Explorer will be inserted here in Phase 3 -->
|