Beautiful API

This page is beautiful: http://www.flickr.com/services/api/. Every service-based web site should have a page like this.

This is a great way to understand and communicate your functionality. If you can’t describe your site in these terms, well, start trying because you should be able to. (You don’t have to make it public.)

I’m not here to talk about the benefits of web services and open APIs — but at least internally, if you can think about your offerings in these clean and explicit terms you’ll be much more successful.

We’ve moved beyond the “If you build it, they will come” days. We’re now in the “If you offer it, they will build it” days. This cool map-based Flickr interface was built because the API existed.