Lexicon Garden

ink.resenha.book.getBook

A book's page from Resenha's index: an edition's readers with their readings, everyone's reviews of it, and its other editions with theirs. By BookHive ID or ISBN-13, so a book BookHive's catalogue doesn't know has one page shared by its readers. Readers the caller blocks are left out. Requires the caller's service token.

Repository @resenha.ink did:plc:v7itjf4h3sb5zuegiiskctqb not from the namespace authority
Details · query
Kindquery
Authoritybook.resenha.ink
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

hiveId

string

The book's BookHive ID. Not a stand-in beginning popfeed-, which names one reader's copy.

  • maxLength: 64

isbn13

string

The edition's ISBN-13, for a book without a BookHive ID.

  • maxLength: 13

Output

application/json

book

requiredref
Reference

counts

requiredref
Reference

editions

requiredarray

Other editions of the book, surest first.

itemsref
Reference

profiles

array
itemsref
Reference

readings

requiredarray

Up to a hundred: the caller's follows first, then by the latest change.

itemsref
Reference

reviews

requiredarray

Every review of this edition the index holds, newest first, each with the whole text and where its likes and comments live (popfeedReview or post) and how many.

itemsref
Reference

#counts

object

Properties

abandoned

requiredinteger
  • minimum: 0

read

requiredinteger
  • minimum: 0

reading

requiredinteger
  • minimum: 0

wantToRead

requiredinteger
  • minimum: 0

#edition

object

One edition as the index knows it: BookHive's facts when it has the book, else what its readers' records say.

Properties

authors

string

Tab-separated, as BookHive stores them.

  • maxLength: 1024

cover

string · uri

covers

array
  • maxLength: 8
itemsstring · uri

genres

array
  • maxLength: 32
itemsstring
  • maxLength: 64

hiveId

string
  • maxLength: 64

isbn13

string
  • maxLength: 13

isbns

array

Every ISBN-13 known for the edition, when there is more than one.

  • maxLength: 16
itemsstring
  • maxLength: 13

language

string
  • maxLength: 64

pages

integer
  • minimum: 1

publisher

string
  • maxLength: 256

title

string
  • maxLength: 512

year

integer

#otherEdition

object

Properties

book

requiredref
Reference

confidence

requiredstring

sure: tied by BookHive's catalogue, a reader's link or Open Library's work. likely: the same title and first author after normalising, which a reader can confirm.

  • knownValues: sure | likely

readers

requiredinteger
  • minimum: 0

reviews

requiredarray
itemsref
Reference

sources

array
itemsstring
  • knownValues: catalogue | bookhive | reader | match | openlibrary | title

#reading

object

One reader's record for the edition, with Resenha's likes and comments on it.

Properties

actor

requiredstring · did

cid

string · cid

commentCount

integer
  • minimum: 0

finishedAt

string · datetime

hasReview

boolean

likeCount

integer
  • minimum: 0

source

requiredstring
  • knownValues: bookhive | popfeed

stars

integer
  • minimum: 1
  • maximum: 10

startedAt

string · datetime

status

string
  • knownValues: wantToRead | reading | read | abandoned

uri

requiredstring · at-uri

The reader's BookHive book record or Popfeed list item.

Similar lexicons

semantic match

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

  • buzz.bookhive.getBook

    query

    Get a book's info. Does not require authentication.

  • ink.resenha.book.resolve

    query not from the namespace authority

    Every key Resenha's index knows for a book, and its other editions, from one key: a BookHive ID, an ISBN-13, an Amazon number or an Open Library work. Learned from BookHive's catalogue, readers' own links between their records in different apps, and Open Library. Public, no sign-in: any book app can fill the slots its records leave empty, such as Popfeed's hiveId or BookHive's ISBN. Answers come from the index alone; nothing is asked of any catalogue for them.

  • ink.resenha.defs

    Views shared by the calls Resenha's server answers.

  • ink.resenha.book.getReviews

    query not from the namespace authority

    Reviews of a book from every source, newest first.

  • ink.resenha.book.getReaders

    query not from the namespace authority

    How many readers have a book, by status.