list-books.json with Booktype 2.x
  • Hi,

    I'm testing Booktype master branch, and particularly how books can be imported from another frontpage application. FMfr and FMen currently use Booktype 1.6.1, and the books list can be retrieved with the list-books.json file (see We used it in the past with the old Publisher frontend, and we still use it now with our custom fm-site application to import the generated ePub, PDF and HTML files.
    Unfortunately, it seems that the feature no longer works with Booktype 2.x (and I find no clue in the code). Is there another way to get the list from an URL, or is it completely removed.

  • 10 Comments sorted by
  • Vote Up0Vote Down Daniel JamesDaniel James
    Posts: 833Member, Sourcefabric Team
    Hi Nicolas,

    In Booktype 2.x the API is far more advanced and is self-documenting.

    First, you need to authenticate, for a quick test you can log into

    Once logged into the demo site:

    So after the upgrade you can do the same at


  • Vote Up0Vote Down Daniel JamesDaniel James
    Posts: 833Member, Sourcefabric Team
  • I'm experimenting the new API with curl. Thanks to the API documentation I managed to retrieve an authentification token, but I can't find a way to pass that token to the following request (e.g. _api/v1/books/). I tried to use it in the header and in the GET parameters, but nothing seems to work and I constantly get {"detail":"Authentication credentials were not provided."}.

    Could you give a simple example? It's probably very easy, but I'm quite new to that kind of API and a bit lost.

  • I just found out the Booktype API is based on Django Rest Framework, so it should be relatively easy to access it using API clients such as coreapi (see
  • I tested all the options provided in the Django Rest Framework documentation, and unfortunately it still doesn't work with coreapi (and the coreapi CLI). Not being able to access the API from a python script is a blocker for us, so some help would be more than welcome.

  • Hi Nicolas, 
    I will provide you step by step manual how to make a proper request later today.

  • Hi Nicolas,

    To retrieve a token you should send a next request:
    curl -X POST \
      -H 'Cache-Control: no-cache' \
      -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
      -F username=admin \
      -F password=admin

    To access a books data:
    curl -X GET \
      -H 'Authorization: Token 7b714b8af74c2191c1c5e898ca8267bc4af45fe9' \
      -H 'Cache-Control: no-cache'

    To use a token auth you need to set the booktype.api.middleware.AuthMiddleware 
    into your MIDDLEWARE_CLASSES and also set the booktype.api.auth.Backend in the AUTHENTICATION_BACKENDS setting.


  • Thanks for your help. I didn't change the content of the server's settings, and thus didn't use the booktype api backend to authenticate. But unfortunately, it still doesn't work.

    In my settings/, I now have:



    I can retrieve the token with:

    curl -X POST \ \
      -H 'Cache-Control: no-cache' \
      -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
      -F username=<login> \
      -F password=<passwd>

    But the following command:

    curl -X GET \ \
      -H 'Authorization: Token <token from the previous command>' \
      -H 'Cache-Control: no-cache'

    still returns {"detail":"Authentication credentials were not provided."}.
  • Also note that if I remove 'django.contrib.auth.backends.ModelBackend' I can't login a all (or retrieve a token) even from the web application.
  • and relying on the api backend fails with the following message: {"non_field_errors":["Unable to log in with provided credentials."]}.