API Reference

Leelaa Reader exposes stable APIs for authentication, license status, library browsing, categories, playback, progress, favorites, and bookmarks.

OpenAPI

• Swagger UI
• OpenAPI YAML

Administrative operations such as importing, deleting, scanning, system configuration, log maintenance, and AI maintenance are not part of the stable third-party contract.

Base URL

http://{host}:8686/api/v1

Same-origin deployments may use /api/v1, while fnOS gateway deployments may use /app/leelaa-reader/api/v1.

Minimum flow

1. POST /auth/login
2. GET /license/status
3. GET /books or GET /books/search
4. GET /books/{bookId} and GET /books/{bookId}/chapters
5. GET /books/{bookId}/download-manifest
6. GET /chapters/{chapterId}/play?raw=1
7. Read and update /auth/reading-progress/{bookId}

Authentication

Authorization: Bearer {token}

For players that cannot attach headers:

/api/v1/chapters/{chapterId}/play?raw=1&access_token={token}

Do not persist user passwords. Re-authenticate after 401. Stop playback and background synchronization after 403 license_required.

Playback rules

• Use the complete server-provided playback manifest;
• Use chapterId as the persistent chapter identifier;
• Never persist list indexes as progress or bookmark identifiers;
• Do not keep only a partial queue around the current chapter;
• Preserve the server-provided order;
• The server owns progress merge and conflict decisions;
• Do not overwrite valid progress with position 0 during restoration.