0 Fork 0

Files

T

John O'Keefe 50282895f5 fix(docs): Work Order 2 — correct stale paths (11 docs + 3 Bruno)

Fix all wrong-path artifacts identified by the audit:
- Kobo sync endpoints (init/bookmark/markup/sync-from-server/analytics): add
  missing :token device segment (6 doc files incl. kobo-protocol.md)
- Highlights/notes update+delete: add missing /:id media-item prefix
- media-items/download_media_item.md: removed (static /uploads route, not an
  API endpoint; info about the file route is recoverable from OPDS docs)
- Bruno: /libraries/visible -> /visibility, /collections/books missing id,
  /audio/0 -> track_index
- operations/troubleshooting.md: same /libraries/visible -> /visibility fix
- media-items/get_audio_track.md + get_audio_chapters.md: /audio/0 examples fixed
- Deleted monolithic docs/developer/api-reference.md (duplicate of split docs)
- Fixed 4 stale entries in docs/developer/api/api-reference.md (split index)

Audit re-run: orphan docs 0, orphan Bruno 6 (all scenario files with literal IDs).

2026-10-24 14:44:19 -04:00

1.1 KiB

Raw Blame History

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.1 KiB Raw Blame History