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.
