Skip to content

Instantly share code, notes, and snippets.

@nichtich
Created May 20, 2012 07:43
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save nichtich/2757229 to your computer and use it in GitHub Desktop.
Save nichtich/2757229 to your computer and use it in GitHub Desktop.
unglue.it API
{
"meta":{
"limit":20,
"logged_in_username":null,
"next":null,
"offset":0,
"previous":null,
"total_count":6
},
"objects":[
{
"activated":null,
"created":"2012-05-11T11:04:47",
"current_total":"358.00",
"deadline":"2012-06-30T00:00:00",
"description":"<p><b>HEAR A SAMPLE;</b></p>\r\n<p>Listen to the first five minutes of <b>RIVERWATCH</b>, narrated by R.C. Bray.</p>\r\n\r\n<iframe width=\"420\" height=\"315\" src=\"//www.youtube.com/embed/iICmmdeFVOo\" frameborder=\"0\" allowfullscreen></iframe>\r\n\r\n<p>This <b>tenth anniversary edition</b> of <b>RIVERWATCH</b>, the debut novel of internationally bestselling urban fantasy author <a href=\"http://www.josephnassise.com\">Joseph Nassise</a>, restores the text of the original edition in its entirety, while at the same time adding never-before-seen material including deleted scenes and an in-depth look at the writing process itself in an essay entitled <i>\"Writing Riverwatch: How a College Dare, a Case of Beer, and an Old Shoebox Launched My Writing Career.\"</i></p>\r\n\r\n<p>Originally published in the small press in 2002 and then released as a mass market paperback by Pocket Books the following year, <b>RIVERWATCH</b> was nominated for both the International Horror Guild Award and the Bram Stoker Award, horror's highest honors, was optioned for feature film production, and later helped launch the inaugural line of horror titles from Italy's Gargoyle Books alongside Chelsea Quinn Yabro's St. Germaine novels. </p>\r\n\r\n<p><b>WHY UNGLUE RIVERWATCH?</b></p>\r\n<p>Unglueing <b>RIVERWATCH</b>:</p>\r\n<p>- Makes an English-language ebook edition of this award-nominated novel available for free to anyone in the world.</p>\r\n<p>- Allows the ebook to be legally copied and shared whenever, wherever and by whomever wants to do so.</p>\r\n<p>- Allows the ebook to be legally converted to whatever format you prefer to have it in and this can be done as many times as necessary in the event you switch devices or want to read it on a different platform.</p>\r\n<p>- Supports privacy as it allows reading of the ebook without authentication, tracking, DRM or other such issues.</p>\r\n<p>- Allows any library, anywhere, to add it to their collection and to provide unlimited lending to all of their patrons.</p>\r\n<p>- Supports the spread of commercial entertainment to locations that might not have been able to afford the retail ebook prior to its unglueing.</p>\r\n<p>- Supports the future endeavors of the writer (me!) by paying a fair wage for the perpetual use license to their creative property.\r\n<p><b><i>Besides, unglueing is fun!</i></b></p>\r\n\r\n<p>Funds pledged in support of ungluing RIVERWATCH will be used to fund the writing of BLACK SKIES, the long-awaited sequel to Riverwatch.</p> \r\n<p></p> \r\n\r\n<p><b>DESCRIPTION</b></p>\r\n<p>A forgotten chamber secreted beneath a river. An ancient evil that lies slumbering in the dark. A guardian determined to fulfill his duty to his last, dying breath.</p>\r\n\r\n<p>As something dark and deadly takes to the skies over Harrington Falls, Jake Caruso and his friends, Sam Travers and Katelynn Riley, find themselves drawn into a primeval conflict set in motion centuries before. \r\n</p>\r\n<p>When fresh blood is spilled and the death toll mounts, these three friends will find themselves faced with a terror beyond imagination, one that will require every vestige of their strength, faith, and determination to confront...and conquer.</p>\r\n\r\n\r\n<b>PRAISE FOR RIVERWATCH</b>\r\n<p>Nominated for the International Horror Guild Award for Outstanding Achievement in a First Novel </p>\r\n\r\n<p>Nominated for the Bram Stoker Award for Superior Achievement in a First Novel </p>\r\n\r\n<p>\"A modern gothic thriller...scary...remarkable.\" - Denver Rocky Mountain News</p>\r\n\r\n<p>\"Nasty, vicious, and perhaps most insidious of all - seductive.\" - Midwest Book Review </p>\r\n\r\n<p>\u201cA heady brew of horror and suspense that has an intense and original flavor. The book has both imagination and muscle. Expect great things from Joe Nassise.\u201d \u2014 International Thriller Award winner Tom Piccirilli</p>\r\n\r\n<p>\u201cRIVERWATCH is a stunning debut movel, intricately plotted and beautifully written. Nassise knows that a good \u201cmonster novel\u201d needs to be fast-paced and terrifying\u2026and he delivers action and frights galore.\u201d \u2014 British Fantasy Award winner Tim Lebbon</p>\r\n\r\n<p><b>ABOUT THE AUTHOR</b></p>\r\n<p>Joseph Nassise is the author of more than a dozen novels, including the internationally bestselling <a href=\"http://www.amazon.com/Heretic-Templar-Chronicles-novel/dp/0615515673/ref=sr_1_4?s=books&ie=UTF8&qid=1337203646&sr=1-4\">TEMPLAR CHRONICLES</a> series, the <a href=\"http://www.amazon.com/Eyes-See-Jeremiah-Hunt-Chronicle/dp/076532718X/ref=sr_1_1?ie=UTF8&qid=1337203489&sr=8-1\">JEREMIAH HUNT</a> trilogy and the <a href=\"http://www.amazon.com/By-Blood-Heroes-Great-Undead/dp/0062048759/ref=tmm_pap_title_0\">GREAT UNDEAD WAR</a> series. He has also written several books in the popular <a href=\"http://www.amazon.com/Library-Gold-Rogue-Angel-Archer/dp/0373621574/ref=sr_1_5?s=books&ie=UTF8&qid=1337204114&sr=1-5\">Rogue Angel</a> action-adventure series.</p>\r\n\r\n<p>His work has been nominated for both the Bram Stoker Award and the International Horror Guild Award and has been translated into half a dozen languages to date. He has written for both the comic and role-playing game industries and also served two terms as president of the Horror Writers Association, the world's largest organization of professional horror and dark fantasy writers.</p>\r\n<p>For more information about Joe's work, visit him on the web at <a href=\"http://www.josephnassise.com\">JosephNassise.com</a></p>\r\n\r\n",
"details":"",
"id":"1",
"in_wishlist":false,
"left":"24642.00",
"license":"CC BY-NC-ND",
"name":"Riverwatch",
"resource_uri":"/api/v1/campaign/1/",
"status":"ACTIVE",
"target":"25000.00",
"work":"/api/v1/work/79399/"
},
{
"activated":null,
"created":"2012-05-11T22:24:20",
"current_total":"324.14",
"deadline":"2012-05-19T00:00:00",
"description":"<p>This is a test campaign for Unglue.it.</p>\r\n\r\n<p>The campaign will succeed no matter what you do, and you'll get the promised ebook no matter what.</p>\r\n\r\n<p>We still need your support. We need any many people as possible to try out all the variations. We need to verify that we can buglessly charge a lot of accounts. we need to see what the communications from Amazon Payments look like. We need to verify what the bank charges really are. We need to exercise lots of muscles that we've built up over the last few months. So that we can get a bit of sleep.</p>\r\n\r\n<p>So pledge a dollar or two. Change your pledge. increase then decrease it. If you're not in the US, pledge a pound or a Euro or a Yen. And if something funny happens, please let us know!</p>\r\n\r\n<p>We will cause this campaign to succeed on May 15, 2012. Pledgers will get charged around midnight EDT. We'll put any funds received towards our expenses. (we bought a block of 100 ISBNs for $575!) And though you already have our undying gratitude, you'll feel great knowing that you really deserve it!</p>\r\n\r\n<p>Eric Hellman, on behalf of the entire Gluejar Team.</p>",
"details":"<p>This ebook was published as chapter 4 of <i>The No Shelf Required Guide to E-book Purchasing</i>, Sue Polanka, Editor. Library Technology Reports, Vol. 47, No.8 (November/December 2011) ISBN 978-0-8389-5836-0. Published by the American Library Association.</p>\r\n<p>The eBook will contain live links, illustrations, and commentary not found in the print version.<p>\r\n<p>The ebook was adapted from a series of posts in the <i><a href=\"http://go-to-hellman.blogspot.com/\">Go To Hellman Blog</a></i> </p>\r\n<ul>\r\n<li><a href=\"http://go-to-hellman.blogspot.com/2011/04/open-access-ebooks-part-1.html\">Part 1</a></li>\r\n<li><a href=\"http://go-to-hellman.blogspot.com/2011/05/open-access-ebooks-part-2-what-does.html\">Part 2. What does Open Access mean for e-books?</a></li>\r\n<li><a href=\"http://go-to-hellman.blogspot.com/2011/05/open-access-ebooks-part-3-business.html\">Part 3. Business Models for Creation</a></li>\r\n<li><a href=\"http://go-to-hellman.blogspot.com/2011/05/open-access-ebooks-part-4-libraries.html\">Part 4. Libraries</a></li>\r\n<li><a href=\"http://go-to-hellman.blogspot.com/2011/05/open-access-ebooks-part-5-changing.html\">Part 5. Changing the World</a></li>\r\n</ul>",
"id":"2",
"in_wishlist":false,
"left":"675.86",
"license":"CC BY-SA",
"name":"Test Campaign: Open Access eBooks",
"resource_uri":"/api/v1/campaign/2/",
"status":"SUCCESSFUL",
"target":"1000.00",
"work":"/api/v1/work/82028/"
},
{
"activated":null,
"created":"2012-05-14T11:25:07",
"current_total":"1765.00",
"deadline":"2012-06-22T00:00:00",
"description":"<p>\u201cBesides being a goldmine for scholars, [Oral Literature in Africa] is a delight for the general reader\u2026 The people and animals and spirits of Africa live, laugh, weep and quarrel between the covers of this book.\u201d\r\n\u2014 Journal of African and Asian Studies <p>\r\n\r\n<p>First published in 1970 by Oxford University Press, this classic study has been hailed as \"the single most authoritative work on oral literature\u201d. It traces the history of story-telling in Africa, and brings to life the diverse forms of creativity across the African continent. Author Ruth Finnegan is thought to have \u201calmost single-handedly created the field of ethnography of language\u201d with this book, and it continues to be a go-to text for anyone studying African culture. <p>\r\n\r\n<p>However, despite its enormous scope and popularity, Finnegan\u2019s book is now out of print. It is particularly hard to find in Africa, where its original retail price was beyond the budget of most university libraries. The non-profit organization <a href=\"http://www.openbookpublishers.com/\">Open Book Publishers</a> is endeavoring to make this definitive book freely available to African students and scholars \u2014 and indeed to any interested readers around the world. The Unglued Ebook will be particularly friendly to people in places with slow Internet connections: once a copy is downloaded, the book can be read offline.<p>\r\n\r\n<p>This edition, developed in conjunction with Cambridge University\u2019s World Oral Literature Project, will include a new introduction and extra digital material. When Finnegan\u2019s book was first published forty years ago, the technology did not exist to include audio clips. Part of this Unglue campaign will involve the creation of a free online repository of Finnegan\u2019s audio recordings of African story-telling, carefully collected during her fieldwork in the late 1960s. These clips, together with original photographs taken during her research, will become available for the first time to researchers everywhere \u2014 an invaluable resource to scholars of African literature and culture. <p>\r\n\r\n<p>After decades of outstanding research, for which she was awarded an Order of the British Empire, Oral Literature in Africa remains the book closest to Finnegan\u2019s heart. \u201cIt was so frustrating to me that my book has been largely unavailable to readers in Africa\u201d, she says. \u201cIt is wonderful to think that it will now be freely read in the very continent it discusses\u201d. <p>\r\n\r\nOpen Book Publishers is an entirely non-profit organization run by academics. It aims to make high-quality research available online to readers everywhere, regardless of their income or access to libraries. By applying a CC BY license to this book, other researchers will be able to add to and extend Finnegan\u2019s original work quickly, easily and freely.<p>\r\n\r\nIf this campaign is successful, the new edition of Oral Literature in Africa will be launched at the World Oral Literature Project Workshop in Cambridge, England on 29-30 June 2012. Premium Donors at the $1,000 level will be invited gratis to this event or another similar event and given two nights free accommodation.<p>",
"details":"If this campaign is successful, the new edition of Oral Literature in Africa will be launched at The World Oral Literature Project Workshop in Cambridge, England on 29-30 June 2012. The complete original text, along with a new introduction and images, will be an Unglued Ebook available to readers everywhere -- along with access to new digital archive materials of audio and visual clips from Ruth Finnegan's research -- if together we raise $7500.00 by June 22, 2012, midnight. \r\n",
"id":"3",
"in_wishlist":false,
"left":"5735.00",
"license":"CC BY",
"name":"Oral Literature in Africa",
"resource_uri":"/api/v1/campaign/3/",
"status":"ACTIVE",
"target":"7500.00",
"work":"/api/v1/work/81724/"
},
{
"activated":null,
"created":"2012-05-15T15:31:03",
"current_total":"122.00",
"deadline":"2012-09-17T00:00:00",
"description":"<p>6-321 is an autobiographical novel for readers in 5th grade and up. I'd wanted to write about sixth grade for a long time before I finally sat down and wrote 6-321. This was the turning point in my life: the moment when a demanding teacher encouraged me and planted the seed of my future career.<p>\r\n<p>There were so many stories to tell, I didn\u2019t know where to start. Sitting down with my class picture one night, I typed everything I could remember about each person: nicknames, talents, witticisms, even what their apartments looked like inside.<p>\r\n<p>In order to make Marc Chaikin (my narrator and alter ego) sound real, I went back to the homework and school newspaper articles I\u2019d saved from that year. Then, very carefully, I impersonated my younger self.<p>\r\n<p>You wouldn\u2019t think that writing your own story would require research, but I spent many hours in the library, taking notes on news stories, ads, and the New York City curricula for sixth grade in 1963. Really, it was fun to dive back into the past, and to discover that, in every issue of Time magazine, there were news events that I vividly remembered.<p>\r\n<p>Many young readers have told me how much they enjoyed 6-321, even though they don\u2019t usually like realistic fiction. That\u2019s a very satisfying compliment. But my favorite response was a review from a young stranger on Amazon: \u201cI thought this book was one of the best books I\u2019ve ever read\u2026 I recommend this book to people of all ages\u2026\u201d That\u2019s the review every author hopes for!<p>\r\n\r\n<p>Michael Laser writes novels for adults and young people, including The Watermelon, Cheater, Dark & Light, Old Buddy Old Pal, The Rain, 6-321, and Children\u2019s Rules for Parents. You'll find his website at michaellaser.com. He also runs News-Basics.com, for students and adults (parents and teachers) who want to quickly learn the background behind major news stories.<p> Here's the link: <a href=http://news-basics.com>News-Basics</a>",
"details":"The Unglued Ebook will be the same edition that was originally published, except for the jacket, which is still to be decided.",
"id":"4",
"in_wishlist":false,
"left":"10878.00",
"license":"CC BY-NC-ND",
"name":"6-321",
"resource_uri":"/api/v1/campaign/4/",
"status":"ACTIVE",
"target":"11000.00",
"work":"/api/v1/work/74286/"
},
{
"activated":null,
"created":"2012-05-15T15:52:41",
"current_total":"300.02",
"deadline":"2012-09-01T00:00:00",
"description":"<p>Seattle-based <a href=\"http://www.nancyrawles.com/\">NANCY RAWLES</a> is the author of three critically-acclaimed and award-winning novels. Her first novel, LOVE LIKE GUMBO, won an American Book Award from the Before Columbus Foundation for its portrayal of a lesbian daughter\u2019s struggle in 1978 for independence from her warm but suffocating LA Creole family.<p> \r\n \r\n<p>Nancy is glad to offer to Unglue her first novel, long out of print, for a new generation of readers.<p>\r\n\r\n<blockquote>\u201cIf a young lesbian of color struggling to come out to her family wants to read a book about a young lesbian of color struggling to come out to her family, she should have it available free as an e-book rather than having to hide a hard copy between the covers, if you know what I mean.\u201d</blockquote> \r\n\r\n<p>First published by Fjord Press in 1997, LOVE LIKE GUMBO is ready to be reissued as an Unglued Ebook because the small press has gone out of business.</p>\r\n\r\n<p>As a playwright, novelist, poet, and teacher, Nancy Rawles is not afraid to experiment in her writing or the media she uses to reach her audience. When she spoke at TEDx Overlake about \u201cLearning to Breathe,\u201d she opened with a quote from Eleanor Roosevelt:</p>\r\n\r\n<p> \u201cYou must do the thing that you think you cannot do.\u201d </p> \r\n \r\n<iframe width=\"445\" height=\"250\" src=\"//www.youtube-nocookie.com/embed/a6fKBuX0lyY?rel=0\" frameborder=\"0\" allowfullscreen></iframe>\r\n\r\n<P>Reviews for LOVE LIKE GUMBO:</p>\r\n\r\n<p>Rawles's paean to Creole family life vividly chronicles the Broussards, who, despite their exodus from Louisiana to South Central Los Angeles, maintain all the traditions of home. . . This novel celebrates family life at the same time it reminds readers that separation doesn't necessarily mean rejection. Library Journal Andrea Caron Kempf, Johnson Cty. Community Coll. Lib., Overland Park, Kan.</P>\r\n\r\n<p>Readers of all ages and backgrounds will love meeting Grace Brussard, who loves both her family and loves her Chicana girl friend. She doesn\u2019t want to have to choose between them. Can she have her Gumbo and eat it too? </p> \r\n\r\n<P>Nancy Rawles is A frequent writer-in-residence at schools and colleges, most recently at Seattle University, Nancy Rawles studied at Brandeis and has received numerous grants and awards for her writing:</P>\r\n\r\n<ul>\r\n<li>2009 Seattle Reads MY JIM</li>\r\n<li>2007 Artist Trust Fellowship in Fiction</li>\r\n<li>2006 American Lib Association Alex Award</li>\r\n<li>2006 Hurston/Wright Foundation Legacy Award in Fiction</li>\r\n<li>2000 Astraea Foundation, Claire of the Moon Award for Fiction</li>\r\n<li>1998 American Book Award, Before Columbus Foundation</li>\r\n<li>1998 Washington State Governor\u2019s Writers Award</li>\r\n</ul>\r\n\r\n<p>Nancy\u2019s second novel, Crawfish Dreams (Doubleday), is also about the Broussard family. Nancy\u2019s third novel, My Jim (Crown), tells the story of the wife and children of Mark Twain\u2019s famous slave character from The Adventures of Huckleberry Finn. My Jim is the winner of an American Library Association\u2019s Alex Award and the Legacy Award in Fiction from the Hurston/Wright Foundation. The Seattle Public Library chose My Jim as the 2009 selection for its popular program Seattle Reads, in which readers all over the city are encouraged to read and participate in discussions about one book.</p>\r\n\r\n<img src=\"https://unglueit.files.wordpress.com/2012/05/nrawles-330-my_jim_brochure.jpg\">\r\n\r\n<p>Want a taste of Nancy's writing? You can read a <a href=\"http://hugohouse.org/content/nancy-rawles-night-no-sleeping\">short story</a> commissioned by Seattle\u2019s Hugo House, free online.</p>\r\n\r\n<p>Here's the beautiful artwork available if you claim one of Nancy's premiums:</p>\r\n\r\n<iframe src=\"https://docs.google.com/a/gluejar.com/viewer?authuser=0&srcid=0B0WZoZaXNvxWWGdFVVRlMzhBZ0E&pid=explorer&a=v&chrome=false&embedded=true\" width=\"445\" height=\"334\"></iframe>",
"details":"The Unglued Ebook edition of LOVE LIKE GUMBO will feature the complete text and cover of the original Fjord edition.",
"id":"5",
"in_wishlist":false,
"left":"14699.98",
"license":"CC BY-NC-ND",
"name":"Love like gumbo",
"resource_uri":"/api/v1/campaign/5/",
"status":"ACTIVE",
"target":"15000.00",
"work":"/api/v1/work/493/"
},
{
"activated":null,
"created":"2012-05-15T16:38:15",
"current_total":"136.00",
"deadline":"2012-09-01T00:00:00",
"description":"\r\nTEN BOOK SET OF EXTRA EASY LEARN-TO-READ BOOKS\r\n\r\n<p>Award winning, <I>Budding Reader Book Set 1: Cat and Rat</i> is the first of five learn-to-read e-book sets \u2013 one for each short vowel sound \u2013 in the <a href=\"http://buddingreader.com/\">Budding Reader</a> e-book series. Developed in consultation with the former Director of Language & Literacy at the Harvard Graduate School of Education and illustrated by an Emmy Award winning artist, this series uses research based best practices for teaching reading. <p>\r\n<p>Budding Reader e-book sets are designed to be a child\u2019s very first readers. The sets ease children into reading by introducing just one or two words at a time. The same story evolves over the course of ten books as new words are added. <p>\r\n<p>Previewing a book dramatically improves comprehension, so Book 1 is a wordless book which compels the child to preview the story before any words are added. Repetition aids brain development, so each subsequent book expands the story by introducing only one or two words at a time. Children, even preschoolers or reluctant readers, learn: 1)They can learn to read if they try; and 2)The more words they learn, the more interesting the story. To better understand what makes <I>Cat and Rat</I> unique, <a href=\"http://files.flipsnack.com/iframe/embed.html?hash=edb7e05f49be7d8d648928012q730948&wmode=window&bgcolor=EEEEEE&t=1327065261\">take a peek behind the cover</a>.\r\n<p>\r\n<p><I>Cat and Rat</i>, which won Gold in the Mom\u2019s Choice Awards for Best in Family-Friendly Products (or Services), was first published in December, 2011 by a socially responsible independent publisher. Inspired by TOMS Shoes one-for-one business model, Budding Reader pledges to donate an e-book to a child in need every time they sell one by working with non-profit literacy organizations. Because of Budding Reader's partnership with non-profit Worldreader, children in Kilgoris, Kenya are reading <I>Cat and Rat</i> on their e-readers today.\r\n \r\n<p>Worldreader has one goal: to make books available to all in the developing world with the help of e-reader and e-book technology. Worldreader, which currently runs programs in Ghana, Kenya and Uganda (and in June 2012 will launch in Rwanda), aims to reach one million children by 2015. This 2011 video speaks to the need for books in the developing world and how e-book technology can help to bring books to all. Soon Worldreader will have distributed 800 e-readers and 96,000 eBooks to children in Africa.<p>\r\n<iframe width=\"450\" height=\"259\" src=\"//www.youtube.com/embed/F55h04PEb08\" frameborder=\"0\" allowfullscreen></iframe>\r\n<p>\r\n\r\nWHY UNGLUE THIS BOOK SET?\r\nLearning to read is a neurologically complex skill which many children find difficult. This book set was designed to make learning to read easier and more fun for emergent readers, even reluctant ones. If you help us reach our funding goal, we'll publish a special Unglue.it edition of this e-book set so that children everywhere can have a positive first learn-to-read experience just in time for the start of the traditional school calendar in the United States. Thank you in advance for your support.\r\n<p>\r\n\r\nTHE BUDDING READER STORY:\r\nAs the mom of a struggling reader, Melinda Thompson had trouble finding learn-to-read books that were easy enough for her child to read. She set out on a mission to produce the easiest learn-to-read books ever and worked with an amazing team to create them. Budding Reader e-books were continually refined over a period of years based on input from literacy experts, teachers, librarians, parents and emergent readers. You can read her story in the book, <I>Tales of the REVOLUTION: True Stories of People who are Poking the Box and Making a Difference</i> published by the Domino Project. <a href=\"http://www.buddingreader.com\">To learn more about Budding Reader, visit buddingreader.com.</a>\r\n<p>",
"details":"If we raise the full campaign amount, we will release an Unglued edition of Cat and Rat with a slightly different cover and perhaps some other features to be determined. All other pages will be the same.",
"id":"6",
"in_wishlist":false,
"left":"49864.00",
"license":"CC BY-NC-SA",
"name":"Budding Reader Book Set 1: Cat and Rat",
"resource_uri":"/api/v1/campaign/6/",
"status":"ACTIVE",
"target":"50000.00",
"work":"/api/v1/work/82055/"
}
]
}
{
"meta":{
"limit":20,
"next":null,
"offset":0,
"previous":null,
"total_count":1
},
"objects":[
{
"edition":"/api/v1/edition/8350/",
"id":"19912",
"resource_uri":"/api/v1/identifier/19912/",
"type":"isbn",
"value":"9780441012039",
"work":"/api/v1/work/5601/"
}
]
}
@nichtich
Copy link
Author

The "work" key should not be something like /api/v1/work/82055/ but just 82055, so you can easier create the URL/URI https://unglue.it/work/82055/. The substring /api/v1/work/ is just a technical artifact that makes use of the API more complicated.

@nichtich
Copy link
Author

Where are the identifiers to better mash up compaigns with other resources? There should be keys for isbn, oclc, and goog (all repeatable!) and a non-repeatable key ltwork to connect to the same work at LibraryThing. The latter can give you links to author pages and common facts such as awards a book has won: http://www.librarything.com/services/librarything.ck.getwork.php

@rdhyee
Copy link

rdhyee commented May 22, 2012

Thanks for taking a look at our API. What we have is a very early cut based on what we could easily get running with tastypie (http://django-tastypie.readthedocs.org/en/latest/). So I will take a look at your comments and as I learn more about tastypie, make changes to improve things. Let me ask one question right away however. How would you handle versioning of the API? Would you object to having the version #in the URI?

@nichtich
Copy link
Author

URIs of works, editions, campaigns etc. should have no version and they should be full URIs of course. For instance instead of /api/v1/identifier/19912/ better http://unglue.it/identifier/19912. This is the REST approach. Such URL/URI can send data in different formats (HTML, JSON...) depending on the query, it could also redirect or you do URL rewriting at your server. But it should be a clean ans stable URI. The API base URL, however, can be versioned, such as http://unglue.it/api/v1/. But this URL should not be used to construct pseudo-URIs. The following URL patterns would make it more clear:

http://unglue.it/api/v1/work?id=5601
http://unglue.it/api/v1/?work=5601

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment