Updating the schema
Although the same media type is used for both request and response documents, certain aspects are only applicable to one or the other. Unless otherwise noted, objects defined by this specification MUST NOT contain any additional members.
Client and server implementations MUST ignore members not recognized by this specification.
However, any object that constitutes or is contained in an attribute MUST NOT contain a key MUST be an object (a “relationships object”).
Additionally, a related resource link MUST NOT change because its relationship’s content changes.
Resource linkage in a compound document allows a client to link together all of the included resource objects without having to Note: The spec does not impart meaning to order of resource identifier objects in linkage arrays of to-many relationships, although implementations may do that.
JSON API is a specification for how a client should request that resources be fetched or modified, and how a server should respond to those requests.
If you catch an error in the specification’s text, or if you write an implementation, please let us know by opening an issue or pull request at our Git Hub repository.