13
I'm about to write an api and thought I'd find some good recommendations on things to look out for, how to write a good api.
I of course did a google search, but aside from this from Dustin Diaz http://www.dustindiaz.com/api-writing-tips/, I haven't really been able to find good recommendations.
What are things that you wish you had done differently when creating an API? What made the biggest difference.
I assuming I'm going to use oauth.
I'm purposely not providing details of the api, as I'm looking for more general recommendations that will hopefully be useful to a larger number of people.