[fanf2]

The draft BCP56 revision, on the use of HTTP as a substrate, is a nice primer on REST API design

https://tools.ietf.org/html/draft-ietf-httpbis-bcp56bis