Best practices for REST API design

Over on the StackOverflow blog: Best practices for REST API design. Some of it is good but I disagree with a bunch of things. I made some notes:

* Use singular


* Use multidimensional selectors, not path/hierarchical selectors:


* Use noun/verb format:

* The [ noun, verb ] pairs map to Facilities for implementation:

[ comment, list ] => CommentLister
[ comment, edit ] => CommentEditor
[ comment, view ] => CommentViewer

Facilities have submit/render functionality and round-trip view state.

* HTTP success 30x's not 2xx's.

* Include a 'submission ID' on <form> elements for idempotent operations

* GET and POST only, don't CRUD URLs, rather invoke business processes