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

773 B

Raw Blame History

method, path, auth, area

method	path	auth	area
GET	/api/analytics/popular-books	jwt	analytics

Get Popular Books

Most-read books for the signed-in user.

Example response

{
  "books": [
    {
      "media_item_id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "1984",
      "author": "George Orwell",
      "read_count": 3,
      "avg_completion": 0.95,
      "last_read": "2026-10-24T13:57:01Z"
    }
  ]
}

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

773 B Raw Blame History

Get Popular Books

Example response

Query parameters

Errors

773 B

Raw Blame History