Skip to content

API reference: books

Looking a book up by its ISBN, for the bookshelf. The server asks the catalogues the settings name, in turn, and answers with the first that knows the book. Only the ISBN goes to them, and nothing keeps it. The bookshelf itself is sealed in the account’s notes.

GET /v1/books/{isbn}

The book an ISBN names, from the catalogues the server asks in turn. Only the ISBN goes to them, never the account, and nothing here keeps it. Needs a session.

Parameters
Name In Type Description
isbn (required) path string

An ISBN-10 or ISBN-13, as typed or scanned: hyphens, spaces and an ISBN label are ignored, and so is a barcode’s price add-on.

Responses
Status Description Body
200

The book.

BookFound application/json
400

Not an ISBN

Problem application/problem+json
401

No valid session token

Problem application/problem+json
404

No catalogue knows it

Problem application/problem+json
429

Too many requests

Problem application/problem+json
500

The service failed

Problem application/problem+json
503

No catalogue offered, or none that might know it answering

Problem application/problem+json