library-rpc

Full-text search over book titles and ISBNs.

RPCbooks.search

Returns books whose title or ISBN contains "query" (case-insensitive). An empty or missing query returns no results. Unlike books.list, this method is not paginated and has no other filters — it is meant for quick free-text lookups such as a search box.

Servers

•mock: https://mock.api.selfdochub.com/rpc

Parameters

NameInTypeRequiredDescription
queryparamsstringFree-text search term matched against title and ISBN.

Responses

result Books matching the search term (possibly empty).

application/json

FieldTypeRequiredDescription
booksarray of objectyes
authorIdstringyesThe id of the Author who wrote this book.
createdAtstring (date-time)yesWhen the book record was created.
idstringyesUnique identifier assigned by the server, prefixed with bk_.
isbnstringyesThe book's ISBN. Must be unique across the catalog.
publishedYearintegeryesThe year the book was first published. Must be between 1450 and next year.
statusstringyesA book's availability. "borrowed" means it is out on an open loan. Allowed values: available, borrowed
titlestringyesThe book's display title, 1-200 characters.
updatedAtstring (date-time)yesWhen the book record was last modified.

Errors

CodeMessageDescription
-32602Invalid params

Request example

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "books.search",
  "params": {
    "query": "query_994"
  }
}

Response example

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "books": [
      {
        "authorId": "authorId_595",
        "createdAt": "createdAt_865",
        "id": "id_1",
        "isbn": "isbn_437",
        "publishedYear": 688,
        "status": "available",
        "title": "title_985",
        "updatedAt": "updatedAt_232"
      }
    ]
  }
}