I was pretty quick to knee jerk ask myself &quot;Why is this any better than any other schema?&quot;  (I was not convinced that &quot;API discovery&quot; was, by itself, a good enough case).<p>Then I read the very practical first sentence of the jsonapi page: &quot;If you&#x27;ve ever argued with your team about the way your JSON responses should be formatted, JSON API can be your anti-bikeshedding tool.&quot;  That alone is probably huge.  May not mean much for individual projects, but it&#x27;s good enough for me to bookmark for the future.