API Documentation

The most important part of a public Web Service API is its documentation. Without proper documentation, you end up with frustrated developers and excessive support request. For example, Amazon’s Associates API.  I’m currently trying to implement BrowseNodeLookup operation. In the latest verson of their documentation, the BrowseNodeLookup operation points to an invalid page. In the second latest version of their document, the critical parameter BrowseNodeID is specified incorrectly (look at Toys 130, it’s actually DVDs). As you go back in time thru their document, you note that all the BrowseNodeID enumerations have been incorrect for quite some time.

Read more »

Technorati Tags:

Amazon Widgets

Widgets, widgets, everywhere. You guessed it. Even Amazon is doing widgets. OK, they’ve always had widgets like Omakase and product links, but now they’ve gone widget crazy just like the rest of the Web. Honestly, most of the widgets don’t seem very interesting, but I’m sure they’ll sell a few extra books. The Unbox widget is cool!
http://widgets.amazon.com/

Read more »

Technorati Tags: