docs: add book-matching, collections, and OPDS API endpoints

Phase 2 part 6: Split advanced features endpoints
- Book Matching: search_books, link_book (manual and auto-link)
- Collections: INDEX.md linking to COLLECTIONS_API.md
- OPDS: feeds, acquisition, publication (OPDS 1.2 protocol)
- Include format conversion details (EPUB to KEPUB)
This commit is contained in:
2026-02-02 08:51:56 -05:00
parent efa046d030
commit 55024bb70a
6 changed files with 392 additions and 0 deletions
+56
View File
@@ -0,0 +1,56 @@
# OPDS Publication
OPDS navigation and publication feeds.
## Navigation Feed
**Endpoint**: `GET /opds/devices/{deviceId}/nav`
**Auth**: Device token required
### Example Request
```http
GET /opds/devices/kobo-id/nav
```
### Response (200 OK - OPDS 1.2 Navigation XML)
Returns OPDS navigation feed with links to:
- Root catalog
- Search
- Collections/shelves
- Filtered views (by author, series, etc.)
## Publication Feeds by Collection
**Endpoint**: `GET /opds/devices/{deviceId}/collections/{collectionId}`
**Auth**: Device token required
### Example Request
```http
GET /opds/devices/kobo-id/collections/collection-uuid
```
### Response (200 OK - OPDS 1.2 XML)
Returns OPDS feed with books in the specified collection.
## Publication Feeds by Shelf
**Endpoint**: `GET /opds/devices/{deviceId}/shelves/{shelfName}`
**Auth**: Device token required
### Example Request
```http
GET /opds/devices/kobo-id/shelves/Favorites
```
### Response (200 OK - OPDS 1.2 XML)
Returns OPDS feed with books on the specified device shelf.
## Try It Out
<!-- API Explorer will be inserted here in Phase 3 -->