From 136f37a3320584273bd8bcae24032b23fe102c62 Mon Sep 17 00:00:00 2001 From: Ethan Date: Fri, 20 Nov 2015 23:49:52 -0800 Subject: [PATCH] Clarify relationship self link PR in response to the confusion in http://discuss.jsonapi.org/t/how-to-handle-an-excessive-number-of-included-resources/209 This isn't adding anything new, just repeating info in another place to make it easier to find amidst our (now quite long) spec. --- _format/1.0/index.md | 4 +++- _format/1.1/index.md | 4 +++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/_format/1.0/index.md b/_format/1.0/index.md index 3a79aee2d..db8143531 100644 --- a/_format/1.0/index.md +++ b/_format/1.0/index.md @@ -252,7 +252,9 @@ A "relationship object" **MUST** contain at least one of the following: * `self`: a link for the relationship itself (a "relationship link"). This link allows the client to directly manipulate the relationship. For example, it would allow a client to remove an `author` from an `article` without - deleting the `people` resource itself. + deleting the `people` resource itself. When fetched successfully, this link + returns the [linkage][resource linkage] for the related resources as its + primary data. (See [Fetching Relationships](#fetching-relationships).) * `related`: a [related resource link] * `data`: [resource linkage] * `meta`: a [meta object][meta] that contains non-standard meta-information about the diff --git a/_format/1.1/index.md b/_format/1.1/index.md index 1ddec846f..b94892b71 100644 --- a/_format/1.1/index.md +++ b/_format/1.1/index.md @@ -252,7 +252,9 @@ A "relationship object" **MUST** contain at least one of the following: * `self`: a link for the relationship itself (a "relationship link"). This link allows the client to directly manipulate the relationship. For example, it would allow a client to remove an `author` from an `article` without - deleting the `people` resource itself. + deleting the `people` resource itself. When fetched successfully, this link + returns the [linkage][resource linkage] for the related resources as its + primary data. (See [Fetching Relationships](#fetching-relationships).) * `related`: a [related resource link] * `data`: [resource linkage] * `meta`: a [meta object][meta] that contains non-standard meta-information about the pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy