buzz.bookhive.getPersonalBookFile
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.
Details · query
| Kind | query |
|---|---|
| Authority | bookhive.buzz |
| Commit rev | 3n2mntoox522e |
| Indexed |
Checks
Validunlimited-stringdefs.main.parameters.properties.contentHashNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "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.",
"errors": [
{
"description": "No such book in the caller's library, or its file is missing from disk",
"name": "NotFound"
}
],
"output": {
"encoding": "application/epub+zip,application/x-mobipocket-ebook,application/x-fictionbook+xml,application/vnd.comicbook+zip,application/octet-stream"
},
"parameters": {
"properties": {
"contentHash": {
"description": "Content hash identifying the book, as returned by getPersonalLibrary",
"type": "string"
}
},
"required": [
"contentHash"
],
"type": "params"
},
"type": "query"
}
},
"id": "buzz.bookhive.getPersonalBookFile",
"lexicon": 1
}