Check out Apigee's ebook on good API-Design: https://pages.apigee.com/rs/apigee/images/api-design-ebook-2... disclaimer: both are my employers