Roy Fielding wrote this post recently on the proliferation of APIs that claim to be REST but are breaking some of the fundamental constraints of a REST style architecture. I was most struck by what Roy seems to be saying is required to document a REST Api. That is it. If you look at most API specs […]