API Reference

The Luzme REST API allows you to query our database for ebook price data.

Since the API is based on REST principles, it’s very easy to write and test applications. You can use your browser to access URLs, and you can use pretty much any HTTP client in any programming language to interact with the API.

Your Request Credentials

All requests to Luzme’s REST API require you to include your Application ID for authentication. So keep it secret.

Retrieving Resources with the HTTP GET Method

You access the API via HTTP. Currently all API commands are for retrieving information, which uses the HTTP GET command. The easiest way to do this is to copy and paste a URL into your web browser’s address bar.

Possible GET Response Status Codes

Commonly used status code are:

Code

200 OK The request was successful and the response body contains the representation requested. 302 FOUND A common redirect response; you can GET the representation at the URI in the Location response header. 304 NOT MODIFIED Your client’s cached version of the representation is still up to date. 401 UNAUTHORIZED The supplied credentials, if any, are not sufficient to access the resource. 403 FORBIDDEN The server understood the request but is refusing to fulfil it, sually because you are over your quota limit. 404 NOT FOUND We could not find what you asked for. 500 SERVER ERROR We couldn’t return the representation. Please try again. ====

List of resources available in API

luzme.com/api/beta/?format=json

returns this:

{
  author: {
    list_endpoint: "/api/beta/author/"
    schema: "/api/beta/author/schema/"
  }
  book: {
    list_endpoint: "/api/beta/book/"
    schema: "/api/beta/book/schema/"
  }
  price_ebook_gb: {
    list_endpoint: "/api/beta/price_ebook_gb/"
    schema: "/api/beta/price_ebook_gb/schema/"
  }
  price_ebook_us: {
    list_endpoint: "/api/beta/price_ebook_us/"
    schema: "/api/beta/price_ebook_us/schema/"
  }
}

Get prices for an ebook

TODO

Get an author

TODO

Find a book

TODO