A couple questions about my API to convert 10 digit ISBNs to 13 digits pointed out somethings I failed to mention earlier.

First, the API actually works both ways. That is, it identifies and validates both 10 and 13 digit ISBNs on input, and returns both versions in the output. Example: 0811822842 and 978081182284-8.

And, as yet, I have no user agreement or usage policy. Except for the disclaimer — don’t blame me if it’s broke — I’m leaving this open (though I’ll probably have to figure something out for future APIs).

Finally, if all you want is a one-time conversion of a list of ISBN’s, you might find Dave Pattern’s solution a bit easier.

update: EdJohnston’s notes about why the ISBN1013 API can’t be linked from the Wikipedia ISBN page.

api, conversion, converter, international standard book numbers, isbn, isbn-13, isbn1013, libraries, library, web service

David Kane asked the web4libbers:

Can anyone tell me what the conversion between ISBN-10 and ISBN-13 is, please. I need to write a little conversion program. Anything in PHP, for example.

Answers:

“There is already an online converter: http://www.isbn.org/converterpub.asp;” some pointing at Wikipedia on ISBNs, Bookland, and EANs; John Blyberg’s PHP port of the PERL ISBN-10/13 tool; some explanation that you have to watch the check digit, and discussion about why you’d need to do all this conversion.

Finally, Tim asked:

Someone should offer single and batch converstion as a free API, not an online form and an offer to have a “representive” call you for larger jobs.

Does anyone want that, or shall I?

And I answered:

http://api.wpopac.net/v1/isbn1013/0811822842 changed: http://api.scriblio.net/v01a/isbn1013/0811822842

Same usage as xISBN and thingISBN. Returns empty result on invalid ISBNs.

Based on Blyberg’s code, incorporates some changes, may not be accurate. Poke at it, break it. Report findings, but don’t blame me if it returns incorrect results (I will try to fix the code/service, though).

Geeky extra: anybody know the Lat and Lon to Bookland? I’d really like to put this post on the map.

bookland, conversion, converter, ean, international standard book numbers, isbn, isbn-13, isbn1013, libraries, library, web service, xisbn

No, I’m not talking about the interface our users see in the web browser — there’s enough argument about that — I’m talking about web services, the technologies that form much of the infrastructure for Web 2.0.

Once upon a time, the technology that displayed a set of data, let’s say catalog records, was inextricably linked to the technology that stored that set of data. As we started to fill our data repositories, we found it usefull to import (and export) the data so that we could benefit from the work others had done and share our contributions with others. These processes were manual, or at least actively managed, and they depended on the notion that we had to have that information in our servers to be used by and displayed for our users.

Then technology evolved. Many applications now separate the components that store and manage the information from the components that display and manipulate it, and a few applications open up their data stores to the public via web services-based APIs. This is the concept that makes HousingMaps, ChicagoCrime, and Flickr Colr Pickr, among so many others, work.

Think about this for a moment: Our ILSs are inventory management systems, but our OPACs are (supposed to be) search and retrieval systems. The difference is obvious from here, but our vendors continue to operate as though you can’t have one without the other.

It might be easier to illustrate this point with an example or two.

Amazon Light is one of hundreds of applications based on Amazon’s web services. It connects Amazon’s inventory system with a custom built search and retrieval system, and it works. The Amazon Lite developers at Kokogiak didn’t need to build the inventory system, they only needed to think about ways to make the Amazon inventory more useful to you. Try it out, you might like the ability to search your local library (via some real hacks) or bookmark things via del.icio.us.

Or, you might not. Because Amazon allows anybody to access their catalog data, everybody has the opportunity to build a better, more usable catalog — or any other application that can benefit from the bibliographic details in it.

Take LibraryThing for example. It’s hard to explain what it is about people who read books that makes them want to list the books they own or have read or are interested in reading, but LibraryThing doesn’t worry about the why. It just answers the need. And because listing books, at least making a detailed list of books, can be time consuming, LibraryThing makes it easier by fetching the full details and book jacket from Amazon’s catalog. LibraryThing doesn’t need to “own” that info, it just needs access to it.

And what’s interesting is that LibraryThing is only one of a number of similar applications. Take a look at AllConsuming, Technorati’s popular books, and listal. These services connect Amazon’s catalog data with other data gathered from users or from web crawls, then they share the results. Here’s Ryan Eby’s lists of owned and wanted books, and here they are in RSS. Why RSS? Take a look at how he’s using the listal feed for his current reading list in his blog (lower-right column).

These are not technology demos. These are real applications. They are examples of how the world changes when you open up access to your catalog data. It’s what happens when we realize that the tools that store and manage our information are separate from the tools that display and manipulate that information.

Obviously, I’m about to make the (now-old) argument that we need to open our OPACs like this, but we also need take the lesson that easy and loose is winning over detailed and difficult — even in XML representations of our catalog data. And after looking at all that’s been done so far, I want to ask: why not adopt Amazon’s web services XML schema?

Is it so bad that it was invented elsewhere? Is it a bad thing that there are perhaps hundreds of applications that are already using data in that format?

Maybe the answer to those questions is yes, but here’s where technology can serve us again: we don’t have to choose. We don’t need to bet on one technology while we watch others progress faster. Our systems can output the same catalog data in any number of different ways. RSS, OpenSearch, MARC-XML, ATOM, EAD, or DC are all possible, easy in fact — if the inventory server architecture is open enough to allow it.

What do I really mean when I say library web services should be like Amazon web services? I mean they should be that accessible, that usable, that hackable. I mean libraries will benefit when people we’ve never met are spending their evenings building new applications to use our data. People are wondering how to get more programmers in libraries (example one, two), but I’m wondering how to make library systems more programmer friendly.

Fired up? Read more with my library catalogs should be like WordPress post, John Blyberg’s ILS customer bill of rights, and Ryan Eby’s open vs. turnkey discussion.

tags: amazon, amazon api, amazon web services, api, dublin core, ead, libraries, library, library catalog, marc, marc-xml, opac data, opensearch, web 2.0, web service, web services, web20, webservice, webservices, xml, xml server