Links Object Clarification Needed


#1

When reading the definition of the links object (http://jsonapi.org/format/#document-links), the documentation seems to suggest that only 2 link names are permitted (self and related) since it says you may define more later, but it isn’t explicit
as to how custom links may be defined. If we understand the spec correctly, this means “self” and “related” are
the only links we can specify. Each link may refer to exactly one URL and one URL only. Is this the right interpretation?


Can Relationship `Links` object hold more than `self` and `related` attributes and do both hold the same URL?
Appropriate way to include additional top-level links?
Resource objects: links vs. relationships
Collections of thin representations of fat resources
#2

Right now, yes, that’s correct. But very shortly, custom links will be allowed with a full mapping to RFC 5988. See here and check out some of the linked issues for the backstory.