From f6f1b972b7b7d06ed01501ce2edf01d94b37347a Mon Sep 17 00:00:00 2001 From: hhware Date: Wed, 20 May 2015 23:56:25 -0500 Subject: [PATCH] ordering-relationships --- format/index.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/format/index.md b/format/index.md index c0f09f449..b17feed41 100644 --- a/format/index.md +++ b/format/index.md @@ -291,6 +291,12 @@ relationship URLs. If present, a *related resource URL* **MUST** be a valid URL, even if the relationship isn't currently associated with any target resources. +> 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. Arrays of resource identifier objects may represent ordered +or unordered relationships, and both types can be mixed in one response +object. + For example, the following article is associated with an `author`: ```javascript @@ -1510,9 +1516,9 @@ Accept: application/vnd.api+json ``` If a client makes a `POST` request to a *relationship URL*, the server -**MUST** append the specified members to the relationship using set -semantics. This means that if a given `type` and `id` is already in the -relationship, the server **MUST NOT** add it again. +**MUST** add the specified members to the relationship unless they are +already present. If a given `type` and `id` is already in the relationship, +the server **MUST NOT** add it again. > Note: This matches the semantics of databases that use foreign keys for has-many relationships. Document-based storage should check the has-many 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