ink.resenha.book.resolve

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.

Repository @resenha.ink did:plc:v7itjf4h3sb5zuegiiskctqb not from the namespace authority
Details · query
Kindquery
Authoritybook.resenha.ink
Indexed

Query

query · GET

Parameters

query string

asin

string
  • maxLength: 16

hiveId

string
  • maxLength: 64

isbn13

string
  • maxLength: 13
  • maxLength: 32

Output

application/json

authors

string
  • maxLength: 1024

editions

requiredarray

Other editions of the same book, surest first.

itemsref
Reference

identifiers

requiredref

The edition asked about, in every key known.

title

string
  • maxLength: 512

#edition

object

Properties

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.

  • knownValues: sure | likely

sources

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

title

string
  • maxLength: 512

Similar lexicons

semantic match

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

  • ink.resenha.book.getBook

    query not from the namespace authority

    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.

  • Resolve book identifiers by hiveId, isbn, isbn13, or goodreadsId. Does not require authentication.

  • Which catalog book a book in the reader's library is, and which of the reader's records in each book app are that book. Resenha writes these when it matches a reader's Popfeed books to BookHive's catalog, so Popfeed's and BookHive's own records are never changed to hold the match.

  • Resolve the community's best guess at which publication an unregistered book is, from registration hints. Returns the publicationId suggested by the most hinters, ties broken by the earliest hint, so the registration flow can pre-fill and skip the search step.

  • Views shared by the calls Resenha's server answers.