JsonApi Schema on FAQ is incorrect


#1

Using the schema here: http://jsonapi.org/faq/#is-there-a-json-schema-describing-json-api (also here: https://github.com/json-api/json-api/blob/gh-pages/schema)
And the data from the homepage here: http://jsonapi.org/
I used the validator here: http://www.jsonschemavalidator.net/

And the validation failed saying that data was the only allowed top level element. If I took away links and jsonapi then it validated OK.

I don’t have the time/need to fix it, posting here in case anyone does - or anyone runs into the same problem.


#2

I’ve had a bit more of a play with this (because I need the schema for my work) and I found that there is a problem with the top level links in the example. If you remove that section, the validation works well. Unfortunately, the validator goes a little berserk when it is included, so it’s difficult to tell what has broken!


#3

Schema on site is not authoritative nor complete as you’ve discovered :frowning:

https://github.com/json-api/json-api/issues/867

https://github.com/json-api/json-api/issues/1011#issuecomment-209496847

https://github.com/json-api/json-api/pull/440#issuecomment-151006988

Also see Development of a validation tool