The REST API Design Handbook

by George Reese

It’s very common to see APIs that mix the resource and services metaphor, define their own status codes, or confuse POST vs. PUT or worse. In many cases, these APIs are trying to be RESTful but failing.