0 Fork 0

Files

T

John O'Keefe 7471ca99e8 docs(analytics,jobs): Work Order 3 batch 4 — device usage, popular books, job create/status

DeviceUsageResponse / PopularBooksResponse / services.JobResult pinned by
type; jobs create uses an inline anonymous request struct (RawMessage pin).
Two UNVERIFIED markers recorded (analytics date-range params, facet value
element shape).

2026-10-24 15:08:18 -04:00

821 B

Raw Blame History

method, path, auth, area

method	path	auth	area
GET	/api/analytics/device-usage	jwt	analytics

Get Device Usage

Per-device sync activity for the signed-in user.

Example response

{
  "devices": [
    {
      "device_id": "550e8400-e29b-41d4-a716-446655440000",
      "device_name": "Kobo Clara",
      "device_type": "kobo",
      "sync_count": 42,
      "last_sync": "2026-10-24T13:57:01Z",
      "total_time_seconds": 3600,
      "total_time_minutes": 60
    }
  ]
}

Query parameters

UNVERIFIED: accepts the standard analytics date-range params; confirm exact names before relying on them.

Errors

Status	Body	When
500	`{"error": "..."}`	unexpected server error

821 B Raw Blame History

Get Device Usage

Example response

Query parameters

Errors

821 B

Raw Blame History