The Elements of APIs

Appendix: REST

REST is good and you should adopt it whole-heartedly.

When I say "REST," I don't mean when to use GET vs. POST (although that's also important). What I mean is that you should read Roy Fielding's dissertation, Architectural Styles and the Design of Network-based Software Architectures, where Representational State Transfer was coined. Not once in its definition does he mention HTTP verbs!

Here are—in my opinion—the important characteristics of the REST architectural style:

TK