net.olamaelcu.livtet.biblio.listBooksOnShelf

List the books on a given shelf: its bookStatus rows and its shelfItem memberships, newest first.

Details · query
Kindquery
Authoritybiblio.livtet.olamaelcu.net
Commit rev3n2ctwqtcqlgi
Indexed

Query

query · GET

Parameters

query string

cursor

string

Opaque pagination cursor.

limit

integer

Maximum number of shelf entries to return.

  • minimum: 1
  • maximum: 100
  • default: 50

shelf

requiredstring · at-uri

AT-URI of the shelf to list books for.

Errors

NotFound

No shelf record exists at the given AT-URI.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • List the shelves a given book is on, as bookStatus rows and shelfItem memberships.

  • List the DIDs that put a given book on one of their shelves.

  • The open shelf: every renderable book the appview has indexed, newest first (record keys are TIDs, so newest means most recently created). The index is fed network-wide from the firehose; any repo's book appears once its spine resolves to content the reader can render.

  • One book's shelf view, hydrated with community counts the shelf list doesn't carry. The readerCount comes from a backlink index over page.cavu.progress records and is garnish, never load-bearing — it is omitted rather than guessed when the index is unreachable.

  • List the authenticated user's personal shelves with per-shelf book counts, plus library-wide totals and storage usage. This is the root call for a catalog client: it carries everything the OPDS root navigation feed renders, in one request. Unpaginated — `personal_shelf` is unique on (userDid, name) and these lists are small.