[Booki-dev] Proposed API for archive.org integration

[adam hyde]

hey raj,

thanks for this. it was really great meeting with you.

We should at some point discuss the epub import as i can see that it
works as expected for some books and not for others. For example this
works (imported from 'my books' menu item):
cinderella00dalziala

and this works:
abroadcranethoma00craniala

those were the first two i tested since our meeting. I have the feeling
it has to do with booki timing out or returning an error if there is no
_existing_ epub. 

anyways, i will discuss this with doug but it /might/ not be on our
side...will report back when we have looked at it again.

Doug is still away for another 3 weeks or so...

adam






On Thu, 2010-04-29 at 12:34 -0700, raj kumar wrote:
> Hi,
> 
> I met with Adam today and we came up with this very simple API for integration with archive.org
> 
> There would be two new services that booki.cc would provide, at the following URLs:
> 
> - http://booki.cc/edit/IA/bookId.epub
> - http://booki.cc/download/IA/bookId.epub
> 
> (the actual urls could be different to fit with booki naming conventions)
> 
> The first url, /edit/IA/bookId.epub, would cause the booki editor to launch, pre-populated with an archive.org epub. The workflow would look something like this:
> 
> 1 . Present log in dialog if user is not already logged in to booki.cc
> 2. Import IA epub, if this is the first time this book is being edited in booki
> 3. Open booki editor with the latest revision
> 
> The second url, /download/IA/bookId.epub, would cause a download of the latest version of the book in one of the following two ways:
> 
> 1. If the book has already been cached in an archive.org item, then this service would issue a 302 redirect to something like
> http://s3.us.archive.org/booki-bookId/bookId.epub
> 2. If the latest version of the book hasn't been cached yet, booki would generate the epub for the user, and then cache it for subsequent requests.
> 
> 
> >From the IA side, we would add a two links to archive.org, one to download the corrected epub, and one to open the editor.
> 
> For example, for this book:
> 
> http://www.archive.org/details/birdbookillustra00reedrich
> 
> In the list of available formats for download on the left, we would add "Corrected EPUB" below "EPUB". This link would point to
> http://booki.cc/download/IA/birdbookillustra00reedrich.epub
> 
> Elsewhere on the page we would have text that says "Please help us correct the OCR data for this book on booki.cc", which a link that points to
> http://booki.cc/edit/IA/birdbookillustra00reedrich.epub
> 
> What do you guys think?
> 
> -raj
> _______________________________________________
> Booki-dev mailing list
> Booki-dev at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/booki-dev-flossmanuals.net


-- 
Adam Hyde
Founder FLOSS Manuals
German mobile : + 49 177 4935122
Email : adam at flossmanuals.net
irc: irc.freenode.net #flossmanuals

"Free manuals for free software"
http://www.flossmanuals.net/about