0 Fork 0

Files

T

John O'Keefe 25ef0d12ba docs(kobo,koreader,collections): Beam WO5 batch 6 — 12 endpoints

Kobo emulation + KOReader calibre-compatible surface backfilled with
device-token auth; collections reorder + update_rule created.

Claude registry: 12 entries. kobo/koreader emulation endpoints all bind
arbitrary protocol POST bodies (markup/bookmark/gettests/sync-from-server,
koreader progress/bookmarks) — registered as AnyJSONObject, not bodyless as
first drafted. Initialization returns the library sync payload, not the init
response.

Contract correction in update_rule.md: the route is SetRuleEnabled ({enabled}
required -> {collection_id, is_smart}); Beam's draft invented rule-field
updates. Reordered response/status: {item_ids} -> {status: reordered}.

make test 9/9.

2026-10-24 16:25:00 -04:00

1.3 KiB

Raw Blame History

method, path, auth, area

method	path	auth	area
POST	/api/sync/kobo/:token/v1/analytics/gettests	device-token	kobo

Analytics GetTests

Status: Coming Soon — Native Kobo sync is not yet supported on real devices; this endpoint is under active development and may change.

Kobo analytics endpoint (device compatibility).

Endpoint: POST /api/sync/kobo/:token/v1/analytics/gettests Auth: Required (Device authentication)

Device Authentication

This endpoint requires device authentication (not user JWT). This is a Kobo compatibility endpoint.

Request Body

Field	Type	Required	Description
(varies)	object	No	Kobo analytics data (format varies)

Example Request

{
  "data": {}
}

Response (200 OK)

{
  "result": "ok"
}

Error Responses

Code	Description
401	Device authentication failed

Notes

This is a Kobo compatibility endpoint used by Kobo devices for analytics purposes. The exact request/response format follows Kobo's proprietary protocol.

1.3 KiB Raw Blame History