Then I read the very practical first sentence of the jsonapi page: "If you've ever argued with your team about the way your JSON responses should be formatted, JSON API can be your anti-bikeshedding tool." That alone is probably huge. May not mean much for individual projects, but it's good enough for me to bookmark for the future.
Not sure if standards like this can prevent bikeshedding. You can always bikeshed about the need to stick to any particular standard. One counterexample to what I'm saying may be one standard Go language formatting with gofmt but that was introduced very early on and became a part of the culture. Too late for that with JSON APIs.
Then I realized I had no actual link ("http://") in my initial post.
I tend to assume all have read exactly what I have read. JSONAPI has huge implications for distributed systems architecture.
Consumers are now expected to add a full library to their project to parse/understand the JSON responses. Also, implementation overload for many languages: http://jsonapi.org/implementations/
At least there's no namespacing or DTD's!
JSON plus a loose adherence to REST won out over SOAP/XML-RPC/WSDL/etc because of its simplicity. Services discovery seems to be a solution in search of a problem.
Even the simple idea of embedded links, with apologies to Dr. Fielding, seem to be a less critical component of REST than was initially believed, since very few modern REST API's actually provide them.
I really wish people would stop calling it REST, since that Rob's the meaning from the term.
Some crucial points that are often preserved even in today's API's that distinguish them from RPC:
- Any REST API will have the concept of resources that are acted upon by HTTP verbs (methods), instead of RPC-style calling a method named in the URI.
- statelessness (no session state assumed on the server)
- use of HTTP status codes
- resource path generally indicates hierarchy or at least a specific 'one path to this representation'
- broad use of existing HTTP headers for metadata instead of a separate "envelope" in the body as in SOAP
- use of common HTTP headers such as Authorization rather than cookies or other carriers of state
Many of the other compromises are not always because of ignorances, but in order to be broadly useful in the most common cases.
I don't disagree with your point about not calling it REST, because this trend does diverge from Dr. Fielding's dissertation in several important areas (for example, content negotiation, as you point out). That's why I prefer the term "loose REST".