48 lines
1.4 KiB
YAML
48 lines
1.4 KiB
YAML
info:
|
|
name: KOReader Sync Progress - SHA-256 Only
|
|
type: http
|
|
seq: 2
|
|
http:
|
|
method: POST
|
|
url: '{{base_url}}/api/v1/koreader/sync/progress'
|
|
auth: inherit
|
|
body:
|
|
type: json
|
|
jsonBody: "{\n \"sync_mode\": \"immediate\",\n \"books\": [\n {\n \
|
|
\ \"sha256\": \"{{book_sha256"
|
|
headers:
|
|
- key: Authorization
|
|
value: Bearer {{koreader_device_token
|
|
|
|
docs: |-
|
|
## KOReader Sync Progress - SHA-256 Only
|
|
|
|
Synchronizes reading progress using only SHA-256 hash for book identification (when UUID is not available).
|
|
|
|
**Method:** POST
|
|
|
|
**Endpoint:** /api/v1/koreader/sync/progress
|
|
|
|
**Authentication:** Bearer token (KOReader device token)
|
|
|
|
**Request Body:**
|
|
- `sync_mode` (string): Sync mode (immediate, deferred)
|
|
- `books` (array): Array of book progress objects
|
|
- `sha256` (string): SHA-256 hash of book file
|
|
- `file_path` (string): Path to book file
|
|
- `percentage` (number): Progress percentage
|
|
- `page` (number): Current page
|
|
- `total_pages` (number): Total pages
|
|
|
|
**Response:**
|
|
- `sync_status` (string): Sync status
|
|
- `books_synced` (number): Number of books synced
|
|
|
|
**Status Codes:**
|
|
- 200: Success
|
|
- 202: Accepted
|
|
- 401: Unauthorized
|
|
- 500: Internal server error
|
|
|
|
**Note:** Use this when book UUID is not available, falling back to SHA-256 hash for identification.
|