John O'Keefe
e21e1facde
All remaining endpoint docs frontmatter'd: media-item bulk ops + audio surface, collections book-listing/preview, koreader rating/review/stats plugin protocol, hash-conflicts JSON list. Scope call (Claude): resolve_hash_conflict.md DELETED — the resolve POST renders an htmx fragment (renderResolved), a web-admin flow under rule 3; only the GET list is a JSON API. update_media_review skipped by Beam (correct): ratings/upsert_media_review.md already covers the PUT. Registry: 16 entries. koreader rating/review/stats all bind koreaderBookRef (query or body) — odd=half-star rating scale; audio track endpoint serves raw bytes (ServeContent, Range) — response nil. Fixed drift: deleted_annotations doc's secondary restore/purge fences unlabeled (gate validates labeled blocks against the ONE frontmatter route); chapters example labeled. UNVERIFIED: 1 (koreader book-ref fields, push_stats). make test 9/9.
34 lines
722 B
Markdown
34 lines
722 B
Markdown
---
|
|
method: POST
|
|
path: /api/sync/koreader/stats
|
|
auth: device-token
|
|
area: koreader
|
|
---
|
|
<!-- source: internal/handlers/koreader.go:1854 KOReaderHandler.PushKOReaderStats -->
|
|
|
|
# Push KOReader Stats
|
|
|
|
Pushes cumulative reading seconds for a book; only the delta above the
|
|
stored watermark becomes a reading_history session.
|
|
|
|
## Example request
|
|
|
|
```json example-request
|
|
{
|
|
"total_seconds": 3600
|
|
}
|
|
```
|
|
|
|
## Example response
|
|
|
|
```json example-response
|
|
{
|
|
"total_seconds": 3600,
|
|
"watermark": 0,
|
|
"delta_seconds": 3600,
|
|
"session_recorded": true,
|
|
"session_seconds": 3600
|
|
}
|
|
```
|
|
|
|
UNVERIFIED: the request body also carries the koreader book reference fields (md5, title, etc.) used to resolve the book; field set not copied here. |