Ask HN: REST API Design Guidelines?

This took some finding but I read your question and remembered coming across one particular article which made a lot of things clear for me when I was looking into building the API for my startup.

Check out "Get Your API Right" by Trek - http://wonderfullyflawed.com/2009/07/02/get-your-api-right.h...

Cheers, I'll have a read

I believe the Twitter API is one of the most widely used API's and would be a good resource. I really like their documentation, it makes integration a lot easier to have it well defined.

Also a huge plus with most API's is a test/development environment. This depends on what the product/service is, but in some cases this is a huge issue.

The classic document on this topic is Richardson's Maturity Model, which is quite well and compactly explained by Fowler in his article:

http://martinfowler.com/articles/richardsonMaturityModel.htm...