Bookshare Developer Blog

Requesting DAISY Books with Images and Retrieving User Download History

The latest update to our book download API allows you to request a new book format: DAISY with images. This kind of download request is considered asynchronous, because it triggers our system to begin packaging the (often large) files for use instead of instantly delivering the binary files. The addition of this new format means we've also updated our response structures so you can get book packaging status info while the book is being prepared. Asynchronous download requests may now get responses that indicate that book packaging is in progress, completed, or cancelled. 

To do an asynchronous download like this, you can poll the status by making the same download request at some defined interval. Each time you will get a status response if the book is not ready, and when it is ready it will return the binary download, just as a normal download request does.

We've also updated the API I to allow retrieval of a month's worth of download history for an individual user, including author and title information, download format, and the packaging status for each book.

If you'll be at ATIA, come hear more about these changes on Thursday, Jan. 31, at 10 a.m. Eastern. The location of the meeting is still TBD, but you can get notification of the room by subscribing to our Twitter feed @BookshareAPI. As always, if you have any questions, please contact us via the Contact Us form.