org.passingreads.book.getRegistrationHints

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.

Details · query
Kindquery
Authoritybook.passingreads.org
Indexed

Query

query · GET

Parameters

query string

bookId

requiredstring

The book's ID (as defined on its QR Code).

Output

application/json

The most-hinted Open Library Edition ID for this bookId (ties broken by the earliest hint). Absent when no one has hinted this book.

Similar lexicons

semantic match

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

  • A hint for which publication this book is, so that registration is especiall.

  • List every dropped book copy that shares a publicationId. Unlike searchBooks this does not de-duplicate — the publication detail page wants every individual copy so the user can see exactly how many are out there and where.

  • 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.

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