On a related note, I think the design and organization of your API's documentation is equally as important as the design of the API itself. Stripe's mostly single-page two-column layout (found here: https://stripe.com/docs/api) is brilliant, and makes it extremely easy to find what you're looking for.