buzz.bookhive.getPersonalBookCover

Cover image for a book in the authenticated user's personal library. Serves the cover extracted from the uploaded file when there is one; otherwise, if the book is linked to a BookHive catalog entry, responds 302 to the public image proxy for that entry. The XRPC equivalent of GET /opds/books/{hash}/cover.

Repository @bookhive.buzz did:plc:enu2j5xjlqsjaylv3du4myh4 namespace authority
Details · query
Kindquery
Authoritybookhive.buzz
Commit rev3n2mntonhbs2e
Indexed

Query

query · GET

Parameters

query string

contentHash

requiredstring

Content hash identifying the book

width

integer

Requested width in pixels for the catalog-cover redirect. Ignored for locally stored covers, which are served at the size they were extracted at.

  • minimum: 32
  • maximum: 1024
  • default: 300

Output

image/jpeg,image/png,image/gif,image/webp

Errors

NotFound

No such book, or the book has neither a stored cover nor a linked catalog entry

Similar lexicons

semantic match

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

  • Get a single book from the authenticated user's personal library.

  • Download the raw ebook file for a book in the authenticated user's personal library. Responds with the stored bytes, a strong ETag equal to the content hash, and a `Content-Disposition: attachment` filename. Honours `If-None-Match` with a 304, so an e-reader syncing on a schedule does not re-download every book. The XRPC equivalent of GET /opds/books/{hash}/download/{name}.ext.

  • Get the authenticated user's personal ebook library.

  • Link a personal library book to a BookHive catalog entry. Overwrites title, authors, and cover from the catalog.