meta {
  name: Bookhoard Kobo Sync
  type: collection
  environment: Bookhoard
}

### Kobo Initialization Endpoint

GET {{baseURL}}/api/sync/kobo/v1/initialization
Authorization: Bearer {{koboToken}}
x-kobo-device: {"DeviceId":"kobo-clara-test","Model":"Kobo Clara","SerialNumber":"N123456789"}

{
  "meta": {
    "name": "Kobo Initialization",
    "description": "Initialize Kobo sync by returning device resources and account page"
  }
}

### Kobo Library Sync Endpoint

POST {{baseURL}}/api/sync/kobo/markup
Authorization: Bearer {{koboToken}}
x-kobo-device: {"DeviceId":"kobo-clara-test","Model":"Kobo Clara","SerialNumber":"N123456789"}

{
  "ReadingSync": [
    {
      "ContentId": "book-uuid-here",
      "PercentRead": 45.6,
      "EntitlementId": "entitlement-id",
      "RemainingTimeMinutes": 120,
      "LastModified": "2026-01-30T20:00:00Z"
    }
  ],
  "BookmarkSync": [
    {
      "BookmarkId": "bookmark-id-1",
      "ContentId": "book-uuid-here",
      "BookmarkText": "highlighted text here",
      "BookmarkType": "annotation",
      "BookmarkTitle": "Chapter 3"
    }
  ]
}

### Kobo Bookmark Sync Endpoint

POST {{baseURL}}/api/sync/kobo/bookmark
Authorization: Bearer {{koboToken}}
x-kobo-device: {"DeviceId":"kobo-clara-test","Model":"Kobo Clara","SerialNumber":"N123456789"}

{
  "BookmarkSync": [
    {
      "BookmarkId": "bookmark-id-2",
      "ContentId": "book-uuid-here",
      "BookmarkText": "This is my note abouts book",
      "BookmarkType": "bookmark",
      "BookmarkTitle": "Important note"
    }
  ]
}

### Kobo Analytics Tests Endpoint

POST {{baseURL}}/api/sync/kobo/v1/analytics/gettests
Authorization: Bearer {{koboToken}}
x-kobo-device: {"DeviceId":"kobo-clara-test","Model":"Kobo Clara","SerialNumber":"N123456789"}

{
  "ContentId": "book-uuid-here",
  "ReadingEvent": "Reading",
  "RemainingTimeMin": 180,
  "PercentRead": 67.8
}